From: Sandro Santilli Date: Tue, 29 Sep 2015 12:31:27 +0000 (+0000) Subject: Update translation templates X-Git-Tag: 2.2.0~61 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=5e43e7e27bcfa727462773ede58351c15f13d314;p=postgis Update translation templates git-svn-id: http://svn.osgeo.org/postgis/trunk@14130 b70326c6-7e19-0410-871a-916f4a2858ee --- diff --git a/doc/po/templates/extras_address_standardizer.xml.pot b/doc/po/templates/extras_address_standardizer.xml.pot index 7b00a01fb..6c8709541 100644 --- a/doc/po/templates/extras_address_standardizer.xml.pot +++ b/doc/po/templates/extras_address_standardizer.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -35,7 +35,7 @@ msgstr "" #. Tag: para #: extras_address_standardizer.xml:6 #, no-c-format -msgid "The code is built into a single postgresql extension library called address_standardizer which can be installed with CREATE EXTENSION address_standardizer;." +msgid "The code is built into a single postgresql extension library called address_standardizer which can be installed with CREATE EXTENSION address_standardizer;. In addition to the address_standardizer extension, a sample data extension called address_standardizer_data_us extensions is built, which contains gaz, lex, and rules tables for US data. This extensions can be installed via: CREATE EXTENSION address_standardizer_data_us;" msgstr "" #. Tag: para @@ -123,7 +123,7 @@ msgid "A composite type that consists of the elements of an address. This is the msgstr "" #. Tag: title -#: extras_address_standardizer.xml:49 extras_address_standardizer.xml:152 extras_address_standardizer.xml:214 extras_address_standardizer.xml:256 extras_address_standardizer.xml:314 extras_address_standardizer.xml:369 +#: extras_address_standardizer.xml:49 extras_address_standardizer.xml:153 extras_address_standardizer.xml:486 extras_address_standardizer.xml:528 extras_address_standardizer.xml:586 extras_address_standardizer.xml:641 #, no-c-format msgid "Description" msgstr "" @@ -137,11 +137,11 @@ msgstr "" #. Tag: para #: extras_address_standardizer.xml:51 #, no-c-format -msgid "The token numbers denote the reference number in the rules table." +msgid "The token numbers denote the output reference number in the ." msgstr "" #. Tag: para -#: extras_address_standardizer.xml:52 extras_address_standardizer.xml:321 extras_address_standardizer.xml:375 +#: extras_address_standardizer.xml:52 extras_address_standardizer.xml:593 extras_address_standardizer.xml:647 #, no-c-format msgid "&address_standardizer_required;" msgstr "" @@ -165,43 +165,43 @@ msgid "house_num" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:62 +#: extras_address_standardizer.xml:62 extras_address_standardizer.xml:397 #, no-c-format msgid "is a text (token number 1): This is the street number on a street. Example 75 in 75 State Street." msgstr "" #. Tag: term -#: extras_address_standardizer.xml:65 +#: extras_address_standardizer.xml:65 extras_address_standardizer.xml:400 #, no-c-format msgid "predir" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:66 +#: extras_address_standardizer.xml:66 extras_address_standardizer.xml:401 #, no-c-format msgid "is text (token number 2): STREET NAME PRE-DIRECTIONAL such as North, South, East, West etc." msgstr "" #. Tag: term -#: extras_address_standardizer.xml:68 +#: extras_address_standardizer.xml:68 extras_address_standardizer.xml:403 #, no-c-format msgid "qual" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:70 +#: extras_address_standardizer.xml:70 extras_address_standardizer.xml:405 #, no-c-format msgid "is text (token number 3): STREET NAME PRE-MODIFIER Example OLD in 3715 OLD HIGHWAY 99." msgstr "" #. Tag: term -#: extras_address_standardizer.xml:73 +#: extras_address_standardizer.xml:73 extras_address_standardizer.xml:408 #, no-c-format msgid "pretype" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:75 +#: extras_address_standardizer.xml:75 extras_address_standardizer.xml:410 #, no-c-format msgid "is text (token number 4): STREET PREFIX TYPE" msgstr "" @@ -213,31 +213,31 @@ msgid "name" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:80 +#: extras_address_standardizer.xml:80 extras_address_standardizer.xml:415 #, no-c-format msgid "is text (token number 5): STREET NAME" msgstr "" #. Tag: term -#: extras_address_standardizer.xml:83 +#: extras_address_standardizer.xml:83 extras_address_standardizer.xml:418 #, no-c-format msgid "suftype" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:85 +#: extras_address_standardizer.xml:85 extras_address_standardizer.xml:420 #, no-c-format msgid "is text (token number 6): STREET POST TYPE e.g. St, Ave, Cir. A street type following the root street name. Example STREET in 75 State Street." msgstr "" #. Tag: term -#: extras_address_standardizer.xml:88 +#: extras_address_standardizer.xml:88 extras_address_standardizer.xml:423 #, no-c-format msgid "sufdir" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:90 +#: extras_address_standardizer.xml:90 extras_address_standardizer.xml:425 #, no-c-format msgid "is text (token number 7): STREET POST-DIRECTIONAL A directional modifier that follows the street name.. Example WEST in 3715 TENTH AVENUE WEST." msgstr "" @@ -344,272 +344,764 @@ msgstr "" msgid "This section lists the PostgreSQL table formats used by the address_standardizer for normalizing addresses. Note that these tables do not need to be named the same as what is referenced here. You can have different lex, gaz, rules tables for each country for example or for your custom geocoder. The names of these tables get passed into the address standardizer functions." msgstr "" +#. Tag: para +#: extras_address_standardizer.xml:143 +#, no-c-format +msgid "The packaged extension address_standardizer_data_us contains data for standardizing US addresses." +msgstr "" + #. Tag: title -#: extras_address_standardizer.xml:145 +#: extras_address_standardizer.xml:146 #, no-c-format msgid "Address Standardizer Tables" msgstr "" #. Tag: refname -#: extras_address_standardizer.xml:148 +#: extras_address_standardizer.xml:149 #, no-c-format msgid "rules table" msgstr "" #. Tag: refpurpose -#: extras_address_standardizer.xml:149 +#: extras_address_standardizer.xml:150 #, no-c-format -msgid "The rules table contains a set of rules that maps address input sequence tokens to standardized output sequence" +msgid "The rules table contains a set of rules that maps address input sequence tokens to standardized output sequence. A rule is defined as a set of input tokens followed by -1 (terminator) followed by set of output tokens followed by -1 followed by number denoting kind of rule followed by ranking of rule." msgstr "" #. Tag: para -#: extras_address_standardizer.xml:153 +#: extras_address_standardizer.xml:154 #, no-c-format msgid "A rules table must have at least the following columns, though you are allowed to add more for your own uses." msgstr "" #. Tag: term -#: extras_address_standardizer.xml:157 extras_address_standardizer.xml:220 extras_address_standardizer.xml:262 +#: extras_address_standardizer.xml:158 extras_address_standardizer.xml:492 extras_address_standardizer.xml:534 #, no-c-format msgid "id" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:159 extras_address_standardizer.xml:222 extras_address_standardizer.xml:264 +#: extras_address_standardizer.xml:160 extras_address_standardizer.xml:494 extras_address_standardizer.xml:536 #, no-c-format msgid "Primary key of table" msgstr "" #. Tag: term -#: extras_address_standardizer.xml:162 +#: extras_address_standardizer.xml:163 #, no-c-format msgid "rule" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:164 +#: extras_address_standardizer.xml:165 #, no-c-format msgid "text field denoting the rule. Details at PAGC Address Standardizer Rule records." msgstr "" #. Tag: para -#: extras_address_standardizer.xml:165 +#: extras_address_standardizer.xml:166 #, no-c-format msgid "A rule consists of a set of non-negative integers representing input tokens, terminated by a -1, followed by an equal number of non-negative integers representing postal attributes, terminated by a -1, followed by an integer representing a rule type, followed by an integer representing the rank of the rule. The rules are ranked from 0 (lowest) to 17 (highest)." msgstr "" #. Tag: para -#: extras_address_standardizer.xml:166 +#: extras_address_standardizer.xml:167 #, no-c-format -msgid "So for example the rule 2 0 2 22 3 -1 5 5 6 7 3 -1 2 6 maps to sequence of tokens TYPE NUMBER TYPE DIRECT QUALIF to the output sequence STREET STREET SUFTYP SUFDIR QUALIF. The rule is an ARC_C rule of rank 6." +msgid "So for example the rule 2 0 2 22 3 -1 5 5 6 7 3 -1 2 6 maps to sequence of output tokens TYPE NUMBER TYPE DIRECT QUALIF to the output sequence STREET STREET SUFTYP SUFDIR QUALIF. The rule is an ARC_C rule of rank 6." msgstr "" #. Tag: para -#: extras_address_standardizer.xml:171 +#: extras_address_standardizer.xml:168 #, no-c-format -msgid "Each rule has a rule type which is denoted by one of following:" +msgid "Numbers for corresponding output tokens are listed in ." msgstr "" -#. Tag: term +#. Tag: title #: extras_address_standardizer.xml:174 #, no-c-format -msgid "MACRO_C" +msgid "Input Tokens" msgstr "" #. Tag: para +#: extras_address_standardizer.xml:175 +#, no-c-format +msgid "Each rule starts with a set of input tokens followed by a terminator -1. Valid input tokens excerpted from PAGC Input Tokens are as follows:" +msgstr "" + +#. Tag: emphasis #: extras_address_standardizer.xml:176 #, no-c-format -msgid "(token number = \"0\"). The class of rules for parsing MACRO clauses." +msgid "Form-Based Input Tokens" msgstr "" #. Tag: term -#: extras_address_standardizer.xml:180 +#: extras_address_standardizer.xml:179 #, no-c-format -msgid "MICRO_C" +msgid "AMPERS" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:182 +#: extras_address_standardizer.xml:181 #, no-c-format -msgid "(token number = \"1\"). The class of rules for parsing full MICRO clauses (ie ARC_C plus CIVIC_C). These rules are not used in the build phase." +msgid "(13). The ampersand (&) is frequently used to abbreviate the word \"and\"." msgstr "" #. Tag: term #: extras_address_standardizer.xml:186 #, no-c-format -msgid "ARC_C" +msgid "DASH" msgstr "" #. Tag: para #: extras_address_standardizer.xml:188 #, no-c-format -msgid "(token number = \"2\"). The class of rules for parsing MICRO clauses, excluding the HOUSE attribute." +msgid "(9). A punctuation character." msgstr "" #. Tag: term -#: extras_address_standardizer.xml:192 +#: extras_address_standardizer.xml:193 #, no-c-format -msgid "CIVIC_C" +msgid "DOUBLE" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:195 +#, no-c-format +msgid "(21). A sequence of two letters. Often used as identifiers." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:200 +#, no-c-format +msgid "FRACT" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:202 +#, no-c-format +msgid "(25). Fractions are sometimes used in civic numbers or unit numbers." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:207 +#, no-c-format +msgid "MIXED" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:209 +#, no-c-format +msgid "(23). An alphanumeric string that contains both letters and digits. Used for identifiers." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:214 +#, no-c-format +msgid "NUMBER" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:216 +#, no-c-format +msgid "(0). A string of digits." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:221 extras_address_standardizer.xml:228 +#, no-c-format +msgid "ORD" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:223 +#, no-c-format +msgid "(15). Representations such as First or 1st. Often used in street names." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:230 +#, no-c-format +msgid "(18). A single letter." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:235 +#, no-c-format +msgid "WORD" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:237 +#, no-c-format +msgid "(1). A word is a string of letters of arbitrary length. A single letter can be both a SINGLE and a WORD." +msgstr "" + +#. Tag: emphasis +#: extras_address_standardizer.xml:242 +#, no-c-format +msgid "Function-based Input Tokens" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:245 extras_address_standardizer.xml:446 +#, no-c-format +msgid "BOXH" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:247 +#, no-c-format +msgid "(14). Words used to denote post office boxes. For example Box or PO Box." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:252 +#, no-c-format +msgid "BUILDH" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:254 +#, no-c-format +msgid "(19). Words used to denote buildings or building complexes, usually as a prefix. For example: Tower in Tower 7A." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:259 +#, no-c-format +msgid "BUILDT" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:261 +#, no-c-format +msgid "(24). Words and abbreviations used to denote buildings or building complexes, usually as a suffix. For example: Shopping Centre." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:266 +#, no-c-format +msgid "DIRECT" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:268 +#, no-c-format +msgid "(22). Words used to denote directions, for example North." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:273 +#, no-c-format +msgid "MILE" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:275 +#, no-c-format +msgid "(20). Words used to denote milepost addresses." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:280 +#, no-c-format +msgid "ROAD" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:282 +#, no-c-format +msgid "(6). Words and abbreviations used to denote highways and roads. For example: the Interstate in Interstate 5" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:287 extras_address_standardizer.xml:456 +#, no-c-format +msgid "RR" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:289 +#, no-c-format +msgid "(8). Words and abbreviations used to denote rural routes. RR." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:294 +#, no-c-format +msgid "TYPE" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:296 +#, no-c-format +msgid "(2). Words and abbreviation used to denote street typess. For example: ST or AVE." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:301 extras_address_standardizer.xml:461 +#, no-c-format +msgid "UNITH" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:303 +#, no-c-format +msgid "(16). Words and abbreviation used to denote internal subaddresses. For example, APT or UNIT." +msgstr "" + +#. Tag: emphasis +#: extras_address_standardizer.xml:308 +#, no-c-format +msgid "Postal Type Input Tokens" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:311 +#, no-c-format +msgid "QUINT" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:313 +#, no-c-format +msgid "(28). A 5 digit number. Identifies a Zip Code" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:318 +#, no-c-format +msgid "QUAD" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:320 +#, no-c-format +msgid "(29). A 4 digit number. Identifies ZIP4." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:325 +#, no-c-format +msgid "PCH" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:327 +#, no-c-format +msgid "(27). A 3 character sequence of letter number letter. Identifies an FSA, the first 3 characters of a Canadian postal code." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:332 +#, no-c-format +msgid "PCT" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:334 +#, no-c-format +msgid "(26). A 3 character sequence of number letter number. Identifies an LDU, the last 3 characters of a Canadian postal code." +msgstr "" + +#. Tag: emphasis +#: extras_address_standardizer.xml:339 +#, no-c-format +msgid "Stopwords" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:194 +#: extras_address_standardizer.xml:340 #, no-c-format -msgid "(token number = \"3\"). The class of rules for parsing the HOUSE attribute." +msgid "STOPWORDS combine with WORDS. In rules a string of multiple WORDs and STOPWORDs will be represented by a single WORD token." msgstr "" #. Tag: term -#: extras_address_standardizer.xml:198 +#: extras_address_standardizer.xml:343 +#, no-c-format +msgid "STOPWORD" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:345 +#, no-c-format +msgid "(7). A word with low lexical significance, that can be omitted in parsing. For example: THE." +msgstr "" + +#. Tag: title +#: extras_address_standardizer.xml:354 +#, no-c-format +msgid "Output Tokens" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:355 +#, no-c-format +msgid "After the first -1 (terminator), follows the output tokens and their order, followed by a terminator -1. Numbers for corresponding output tokens are listed in . What are allowed is dependent on kind of rule. Output tokens valid for each rule type are listed in ." +msgstr "" + +#. Tag: title +#: extras_address_standardizer.xml:358 +#, no-c-format +msgid "Rule Types and Rank" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:359 +#, no-c-format +msgid "The final part of the rule is the rule type which is denoted by one of the following, followed by a rule rank. The rules are ranked from 0 (lowest) to 17 (highest)." +msgstr "" + +#. Tag: emphasis +#: extras_address_standardizer.xml:361 +#, no-c-format +msgid "MACRO_C" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:362 +#, no-c-format +msgid "(token number = \"0\"). The class of rules for parsing MACRO clauses such as PLACE STATE ZIP" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:363 +#, no-c-format +msgid "MACRO_C output tokens (excerpted from http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:366 +#, no-c-format +msgid "CITY" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:368 +#, no-c-format +msgid "(token number \"10\"). Example \"Albany\"" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:372 +#, no-c-format +msgid "STATE" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:374 +#, no-c-format +msgid "(token number \"11\"). Example \"NY\"" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:378 +#, no-c-format +msgid "NATION" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:380 +#, no-c-format +msgid "(token number \"12\"). This attribute is not used in most reference files. Example \"USA\"" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:384 +#, no-c-format +msgid "POSTAL" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:386 +#, no-c-format +msgid "(token number \"13\"). (SADS elements \"ZIP CODE\" , \"PLUS 4\" ). This attribute is used for both the US Zip and the Canadian Postal Codes." +msgstr "" + +#. Tag: emphasis +#: extras_address_standardizer.xml:391 +#, no-c-format +msgid "MICRO_C" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:392 +#, no-c-format +msgid "(token number = \"1\"). The class of rules for parsing full MICRO clauses (such as House, street, sufdir, predir, pretyp, suftype, qualif) (ie ARC_C plus CIVIC_C). These rules are not used in the build phase." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:393 +#, no-c-format +msgid "MICRO_C output tokens (excerpted from http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:395 +#, no-c-format +msgid "HOUSE" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:413 +#, no-c-format +msgid "street" +msgstr "" + +#. Tag: emphasis +#: extras_address_standardizer.xml:430 +#, no-c-format +msgid "ARC_C" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:431 +#, no-c-format +msgid "(token number = \"2\"). The class of rules for parsing MICRO clauses, excluding the HOUSE attribute. As such uses same set of output tokens as MICRO_C minus the HOUSE token." +msgstr "" + +#. Tag: emphasis +#: extras_address_standardizer.xml:433 +#, no-c-format +msgid "CIVIC_C" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:434 +#, no-c-format +msgid "(token number = \"3\"). The class of rules for parsing the HOUSE attribute." +msgstr "" + +#. Tag: emphasis +#: extras_address_standardizer.xml:436 #, no-c-format msgid "EXTRA_C" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:200 +#: extras_address_standardizer.xml:437 +#, no-c-format +msgid "(token number = \"4\"). The class of rules for parsing EXTRA attributes - attributes excluded from geocoding. These rules are not used in the build phase." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:439 +#, no-c-format +msgid "EXTRA_C output tokens (excerpted from http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:441 +#, no-c-format +msgid "BLDNG" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:443 +#, no-c-format +msgid "(token number 0): Unparsed building identifiers and types." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:448 #, no-c-format -msgid "(token number = \"4\"). The class of rules for parsing EXTRA attributes - attributes excluded from geocoding. These rules are not used in the build phase." +msgid "i(token number 14): The BOX in BOX 3B" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:451 +#, no-c-format +msgid "BOXT" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:453 +#, no-c-format +msgid "(token number 15): The 3B in BOX 3B" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:458 +#, no-c-format +msgid "(token number 8): The RR in RR 7" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:463 +#, no-c-format +msgid "(token number 16): The APT in APT 3B" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:466 +#, no-c-format +msgid "UNITT" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:468 +#, no-c-format +msgid "(token number 17): The 3B in APT 3B" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:471 +#, no-c-format +msgid "UNKNWN" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:473 +#, no-c-format +msgid "(token number 9): An otherwise unclassified output." msgstr "" #. Tag: refname -#: extras_address_standardizer.xml:210 +#: extras_address_standardizer.xml:482 #, no-c-format msgid "lex table" msgstr "" #. Tag: refpurpose -#: extras_address_standardizer.xml:211 +#: extras_address_standardizer.xml:483 #, no-c-format -msgid "A lex table is used to classify alphanumeric input and associate that input with (a) input tokens ( See Input Tokens) and (b) standardized representations." +msgid "A lex table is used to classify alphanumeric input and associate that input with (a) input tokens ( See ) and (b) standardized representations." msgstr "" #. Tag: para -#: extras_address_standardizer.xml:215 +#: extras_address_standardizer.xml:487 #, no-c-format -msgid "A lex (short for lexicon) table is used to classify alphanumeric input and associate that input with (a) input tokens and (b) standardized representations. Things you will find in these tables are ONE mapped to stdworkd: 1." +msgid "A lex (short for lexicon) table is used to classify alphanumeric input and associate that input with and (b) standardized representations. Things you will find in these tables are ONE mapped to stdword: 1." msgstr "" #. Tag: para -#: extras_address_standardizer.xml:217 +#: extras_address_standardizer.xml:489 #, no-c-format msgid "A lex has at least the following columns in the table. You may add" msgstr "" #. Tag: term -#: extras_address_standardizer.xml:225 extras_address_standardizer.xml:267 +#: extras_address_standardizer.xml:497 extras_address_standardizer.xml:539 #, no-c-format msgid "seq" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:227 extras_address_standardizer.xml:269 +#: extras_address_standardizer.xml:499 #, no-c-format msgid "integer: definition number?" msgstr "" #. Tag: term -#: extras_address_standardizer.xml:231 extras_address_standardizer.xml:272 +#: extras_address_standardizer.xml:503 extras_address_standardizer.xml:544 #, no-c-format msgid "word" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:233 extras_address_standardizer.xml:274 +#: extras_address_standardizer.xml:505 extras_address_standardizer.xml:546 #, no-c-format msgid "text: the input word" msgstr "" #. Tag: term -#: extras_address_standardizer.xml:236 extras_address_standardizer.xml:277 +#: extras_address_standardizer.xml:508 extras_address_standardizer.xml:549 #, no-c-format msgid "stdword" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:238 extras_address_standardizer.xml:279 +#: extras_address_standardizer.xml:510 extras_address_standardizer.xml:551 #, no-c-format msgid "text: the standardized replacement word" msgstr "" #. Tag: term -#: extras_address_standardizer.xml:241 extras_address_standardizer.xml:282 +#: extras_address_standardizer.xml:513 extras_address_standardizer.xml:554 #, no-c-format msgid "token" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:243 extras_address_standardizer.xml:284 +#: extras_address_standardizer.xml:515 extras_address_standardizer.xml:556 #, no-c-format msgid "integer: the kind of word it is. Only if it is used in this context will it be replaced. Refer to PAGC Tokens." msgstr "" #. Tag: refname -#: extras_address_standardizer.xml:252 +#: extras_address_standardizer.xml:524 #, no-c-format msgid "gaz table" msgstr "" #. Tag: refpurpose -#: extras_address_standardizer.xml:253 +#: extras_address_standardizer.xml:525 #, no-c-format -msgid "A gaz table is used to standardize place names and associate that input with (a) input tokens ( See Input Tokens) and (b) standardized representations." +msgid "A gaz table is used to standardize place names and associate that input with (a) input tokens ( See ) and (b) standardized representations." msgstr "" #. Tag: para -#: extras_address_standardizer.xml:257 +#: extras_address_standardizer.xml:529 #, no-c-format -msgid "A gaz (short for gazeteer) table is used to classify place names and associate that input with (a) input tokens and (b) standardized representations. For example if you are in US, you may load these with State Names and associated abbreviations." +msgid "A gaz (short for gazeteer) table is used to classify place names and associate that input with and (b) standardized representations. For example if you are in US, you may load these with State Names and associated abbreviations." msgstr "" #. Tag: para -#: extras_address_standardizer.xml:259 +#: extras_address_standardizer.xml:531 #, no-c-format msgid "A gaz table has at least the following columns in the table. You may add more columns if you wish for your own purposes." msgstr "" +#. Tag: para +#: extras_address_standardizer.xml:541 +#, no-c-format +msgid "integer: definition number? - identifer used for that instance of the word" +msgstr "" + #. Tag: title -#: extras_address_standardizer.xml:295 +#: extras_address_standardizer.xml:567 #, no-c-format msgid "Address Standardizer Functions" msgstr "" #. Tag: refname -#: extras_address_standardizer.xml:298 +#: extras_address_standardizer.xml:570 #, no-c-format msgid "parse_address" msgstr "" #. Tag: refpurpose -#: extras_address_standardizer.xml:300 +#: extras_address_standardizer.xml:572 #, no-c-format msgid "Takes a 1 line address and breaks into parts" msgstr "" #. Tag: funcprototype -#: extras_address_standardizer.xml:305 +#: extras_address_standardizer.xml:577 #, no-c-format msgid "record parse_address text address" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:316 +#: extras_address_standardizer.xml:588 #, no-c-format msgid "Returns takes as input an address, and returns a record output consisting of fields num, street, street2, address1, city, state, zip, zipplus, country." msgstr "" #. Tag: para -#: extras_address_standardizer.xml:320 extras_address_standardizer.xml:374 +#: extras_address_standardizer.xml:592 extras_address_standardizer.xml:646 #, no-c-format msgid "Availability: 2.2.0" msgstr "" #. Tag: title -#: extras_address_standardizer.xml:326 extras_address_standardizer.xml:380 +#: extras_address_standardizer.xml:598 extras_address_standardizer.xml:652 #, no-c-format msgid "Examples" msgstr "" #. Tag: programlisting -#: extras_address_standardizer.xml:328 +#: extras_address_standardizer.xml:600 #, no-c-format msgid "" "SELECT num, street, city, zip, zipplus FROM parse_address('1 Devonshire Place, Boston, MA 02109-1234');\n" @@ -619,51 +1111,81 @@ msgid "" msgstr "" #. Tag: title -#: extras_address_standardizer.xml:334 extras_address_standardizer.xml:391 +#: extras_address_standardizer.xml:606 extras_address_standardizer.xml:666 #, no-c-format msgid "See Also" msgstr "" #. Tag: refname -#: extras_address_standardizer.xml:342 +#: extras_address_standardizer.xml:614 #, no-c-format msgid "standardize_address" msgstr "" #. Tag: refpurpose -#: extras_address_standardizer.xml:344 +#: extras_address_standardizer.xml:616 #, no-c-format msgid "Returns an stdaddr form of an input address utilizing lex, gaz, and rule tables." msgstr "" #. Tag: funcsynopsis -#: extras_address_standardizer.xml:348 +#: extras_address_standardizer.xml:620 #, no-c-format msgid " stdaddr standardize_address text lextab text gaztab text rultab text address stdaddr standardize_address text lextab text gaztab text rultab text micro text macro " msgstr "" #. Tag: para -#: extras_address_standardizer.xml:371 +#: extras_address_standardizer.xml:643 #, no-c-format msgid "Returns an form of an input address utilizing table name, , and table names and an address." msgstr "" +#. Tag: para +#: extras_address_standardizer.xml:653 +#, no-c-format +msgid "Using address_standardizer_data_us extension" +msgstr "" + +#. Tag: programlisting +#: extras_address_standardizer.xml:654 +#, no-c-format +msgid "" + "CREATE EXTENSION address_standardizer_data_us; -- only needs to be done once\n" + "SELECT house_num, name, suftype, city, country, state, unit FROM standardize_address('us_lex', \n" + " 'us_gaz', 'us_rules', 'One Devonshire Place, PH 301, Boston, MA 02109-1234');" +msgstr "" + +#. Tag: screen +#: extras_address_standardizer.xml:655 +#, no-c-format +msgid "" + "house_num | name | suftype | city | country | state | unit\n" + "----------+------------+---------+--------+---------+---------------+-----------------\n" + "1 | DEVONSHIRE | PLACE | BOSTON | USA | MASSACHUSETTS | # PENTHOUSE 301" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:656 +#, no-c-format +msgid "Using tables packaged with tiger geocoder. This example only works if you installed postgis_tiger_geocoder." +msgstr "" + #. Tag: programlisting -#: extras_address_standardizer.xml:382 +#: extras_address_standardizer.xml:657 #, no-c-format msgid "" "SELECT * FROM standardize_address('tiger.pagc_lex', \n" - " 'tiger.pagc_gaz', 'tiger.pagc_rules', 'One Devonshire Place, PH 301, Boston, MA 02109-1234');" + " 'tiger.pagc_gaz', 'tiger.pagc_rules', 'One Devonshire Place, PH 301, Boston, MA 02109-1234');" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:384 +#: extras_address_standardizer.xml:659 #, no-c-format msgid "Make easier to read we'll dump output using hstore extension CREATE EXTENSION hstore; you need to install" msgstr "" #. Tag: programlisting -#: extras_address_standardizer.xml:385 +#: extras_address_standardizer.xml:660 #, no-c-format msgid "" "SELECT (each(hstore(p))).* \n" @@ -672,7 +1194,7 @@ msgid "" msgstr "" #. Tag: screen -#: extras_address_standardizer.xml:386 +#: extras_address_standardizer.xml:661 #, no-c-format msgid "" "key | value\n" @@ -697,7 +1219,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_address_standardizer.xml:393 +#: extras_address_standardizer.xml:668 #, no-c-format msgid ", , , , " msgstr "" diff --git a/doc/po/templates/extras_tigergeocoder.xml.pot b/doc/po/templates/extras_tigergeocoder.xml.pot index 2683e125a..81ed31b92 100644 --- a/doc/po/templates/extras_tigergeocoder.xml.pot +++ b/doc/po/templates/extras_tigergeocoder.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -23,7 +23,7 @@ msgstr "" #. Tag: para #: extras_tigergeocoder.xml:7 #, no-c-format -msgid "There are four components to the geocoder: the data loader functions, the address normalizer, the address geocoder, and the reverse geocoder. The latest version updated to use the TIGER 2011 and 2012 census data is located in the extras/tiger_geocoder/tiger_2011 folder. It defaults to downloading and installing TIGER 2012 files." +msgid "There are four components to the geocoder: the data loader functions, the address normalizer, the address geocoder, and the reverse geocoder." msgstr "" #. Tag: para @@ -53,137 +53,143 @@ msgstr "" #. Tag: para #: extras_tigergeocoder.xml:16 #, no-c-format -msgid "If you are using tiger geocoder (tiger_2010), you can upgrade the scripts using the accompanying upgrade_geocoder.bat / .sh scripts in tiger_2011. One major change between tiger_2010 and tiger_2011/tiger_2012 is that the county and county and state tables are no longer broken out by state. We'll be refining the upgrade scripts until release. If you have data from tiger_2010 and want replace with tiger_2012 refer to " +msgid "If you are using tiger geocoder (tiger_2010), you can upgrade the scripts using the accompanying upgrade_geocoder.bat / .sh scripts in extras/tiger. One major change between tiger_2010 and tiger_2011+ is that the county and county and state tables are no longer broken out by state. If you have data from tiger_2010 and want replace with tiger_2015 refer to " msgstr "" #. Tag: para #: extras_tigergeocoder.xml:23 #, no-c-format +msgid "New in PostGIS 2.2.0 release is support for Tiger 2015 data and inclusion of Address Standardizer as part of PostGIS." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:24 +#, no-c-format msgid "New in PostGIS 2.1.0 release is ability to install tiger geocoder with PostgreSQL extension model if you are running PostgreSQL 9.1+. Refer to for details." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:25 +#: extras_tigergeocoder.xml:26 #, no-c-format -msgid "Also new in PostGIS 2.1.0 is integration with pagc address standardizer PostgreSQL extension which source can be downloaded from PAGC PostgreSQL address standardizer extension and after install and install of the library in your PostGIS database, you can use the function as a drop in replacement for in-built . Refer to for compile and installation instructions." +msgid "The function as a drop in replacement for in-built . Refer to for compile and installation instructions." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:29 +#: extras_tigergeocoder.xml:30 #, no-c-format msgid "Design:" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:30 +#: extras_tigergeocoder.xml:31 #, no-c-format msgid "The goal of this project is to build a fully functional geocoder that can process an arbitrary United States address string and using normalized TIGER census data, produce a point geometry and rating reflecting the location of the given address and likeliness of the location. The higher the rating number the worse the result." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:32 +#: extras_tigergeocoder.xml:33 #, no-c-format msgid "The reverse_geocode function, introduced in PostGIS 2.0.0 is useful for deriving the street address and cross streets of a GPS location." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:33 +#: extras_tigergeocoder.xml:34 #, no-c-format msgid "The geocoder should be simple for anyone familiar with PostGIS to install and use, and should be easily installable and usable on all platforms supported by PostGIS." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:34 +#: extras_tigergeocoder.xml:35 #, no-c-format msgid "It should be robust enough to function properly despite formatting and spelling errors." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:35 +#: extras_tigergeocoder.xml:36 #, no-c-format msgid "It should be extensible enough to be used with future data updates, or alternate data sources with a minimum of coding changes." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:37 +#: extras_tigergeocoder.xml:38 #, no-c-format msgid "The tiger schema must be added to the database search path for the functions to work properly." msgstr "" #. Tag: title -#: extras_tigergeocoder.xml:41 +#: extras_tigergeocoder.xml:42 #, no-c-format msgid "Tiger Geocoder" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:43 +#: extras_tigergeocoder.xml:44 #, no-c-format msgid "There are a couple other open source geocoders for PostGIS, that unlike tiger geocoder have the advantage of multi-country geocoding support" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:45 +#: extras_tigergeocoder.xml:46 #, no-c-format msgid "Nominatim and uses OpenStreetMap gazeteer formatted data. It requires osm2pgsql for loading the data, PostgreSQL 8.4+ and PostGIS 1.5+ to function. It is packaged as a webservice interface and seems designed to be called as a webservice. Just like the tiger geocoder, it has both a geocoder and a reverse geocoder component. From the documentation, it is unclear if it has a pure SQL interface like the tiger geocoder, or if a good deal of the logic is implemented in the web interface." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:48 +#: extras_tigergeocoder.xml:49 #, no-c-format msgid "GIS Graphy also utilizes PostGIS and like Nominatim works with OpenStreetMap (OSM) data. It comes with a loader to load OSM data and similar to Nominatim is capable of geocoding not just US. Much like Nominatim, it runs as a webservice and relies on Java 1.5, Servlet apps, Solr. GisGraphy is cross-platform and also has a reverse geocoder among some other neat features." msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:53 +#: extras_tigergeocoder.xml:54 #, no-c-format msgid "Drop_Indexes_Generate_Script" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:55 +#: extras_tigergeocoder.xml:56 #, no-c-format msgid "Generates a script that drops all non-primary key and non-unique indexes on tiger schema and user specified schema. Defaults schema to tiger_data if no schema is specified." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:60 +#: extras_tigergeocoder.xml:61 #, no-c-format msgid "text Drop_Indexes_Generate_Script text param_schema=tiger_data" msgstr "" #. Tag: title -#: extras_tigergeocoder.xml:68 extras_tigergeocoder.xml:110 extras_tigergeocoder.xml:152 extras_tigergeocoder.xml:208 extras_tigergeocoder.xml:270 extras_tigergeocoder.xml:315 extras_tigergeocoder.xml:355 extras_tigergeocoder.xml:394 extras_tigergeocoder.xml:439 extras_tigergeocoder.xml:497 extras_tigergeocoder.xml:554 extras_tigergeocoder.xml:609 extras_tigergeocoder.xml:654 extras_tigergeocoder.xml:733 extras_tigergeocoder.xml:818 extras_tigergeocoder.xml:865 extras_tigergeocoder.xml:937 extras_tigergeocoder.xml:1002 +#: extras_tigergeocoder.xml:69 extras_tigergeocoder.xml:111 extras_tigergeocoder.xml:153 extras_tigergeocoder.xml:209 extras_tigergeocoder.xml:271 extras_tigergeocoder.xml:316 extras_tigergeocoder.xml:357 extras_tigergeocoder.xml:396 extras_tigergeocoder.xml:441 extras_tigergeocoder.xml:499 extras_tigergeocoder.xml:556 extras_tigergeocoder.xml:611 extras_tigergeocoder.xml:656 extras_tigergeocoder.xml:735 extras_tigergeocoder.xml:820 extras_tigergeocoder.xml:867 extras_tigergeocoder.xml:939 extras_tigergeocoder.xml:1004 #, no-c-format msgid "Description" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:70 +#: extras_tigergeocoder.xml:71 #, no-c-format msgid "Generates a script that drops all non-primary key and non-unique indexes on tiger schema and user specified schema. Defaults schema to tiger_data if no schema is specified." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:71 +#: extras_tigergeocoder.xml:72 #, no-c-format msgid "This is useful for minimizing index bloat that may confuse the query planner or take up unnecessary space. Use in combination with to add just the indexes used by the geocoder." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:74 extras_tigergeocoder.xml:158 extras_tigergeocoder.xml:277 extras_tigergeocoder.xml:359 extras_tigergeocoder.xml:402 extras_tigergeocoder.xml:457 extras_tigergeocoder.xml:617 extras_tigergeocoder.xml:891 extras_tigergeocoder.xml:963 +#: extras_tigergeocoder.xml:75 extras_tigergeocoder.xml:159 extras_tigergeocoder.xml:278 extras_tigergeocoder.xml:361 extras_tigergeocoder.xml:404 extras_tigergeocoder.xml:459 extras_tigergeocoder.xml:619 extras_tigergeocoder.xml:893 extras_tigergeocoder.xml:965 #, no-c-format msgid "Availability: 2.0.0" msgstr "" #. Tag: title -#: extras_tigergeocoder.xml:81 extras_tigergeocoder.xml:122 extras_tigergeocoder.xml:165 extras_tigergeocoder.xml:409 extras_tigergeocoder.xml:464 extras_tigergeocoder.xml:522 extras_tigergeocoder.xml:577 extras_tigergeocoder.xml:624 extras_tigergeocoder.xml:700 extras_tigergeocoder.xml:784 extras_tigergeocoder.xml:828 extras_tigergeocoder.xml:896 +#: extras_tigergeocoder.xml:82 extras_tigergeocoder.xml:123 extras_tigergeocoder.xml:166 extras_tigergeocoder.xml:411 extras_tigergeocoder.xml:466 extras_tigergeocoder.xml:524 extras_tigergeocoder.xml:579 extras_tigergeocoder.xml:626 extras_tigergeocoder.xml:702 extras_tigergeocoder.xml:786 extras_tigergeocoder.xml:830 extras_tigergeocoder.xml:898 #, no-c-format msgid "Examples" msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:82 +#: extras_tigergeocoder.xml:83 #, no-c-format msgid "" "SELECT drop_indexes_generate_script() As actionsql;\n" @@ -223,49 +229,49 @@ msgid "" msgstr "" #. Tag: title -#: extras_tigergeocoder.xml:88 extras_tigergeocoder.xml:129 extras_tigergeocoder.xml:172 extras_tigergeocoder.xml:239 extras_tigergeocoder.xml:293 extras_tigergeocoder.xml:332 extras_tigergeocoder.xml:372 extras_tigergeocoder.xml:416 extras_tigergeocoder.xml:474 extras_tigergeocoder.xml:532 extras_tigergeocoder.xml:586 extras_tigergeocoder.xml:631 extras_tigergeocoder.xml:710 extras_tigergeocoder.xml:796 extras_tigergeocoder.xml:839 extras_tigergeocoder.xml:911 extras_tigergeocoder.xml:979 extras_tigergeocoder.xml:1019 +#: extras_tigergeocoder.xml:89 extras_tigergeocoder.xml:130 extras_tigergeocoder.xml:173 extras_tigergeocoder.xml:240 extras_tigergeocoder.xml:294 extras_tigergeocoder.xml:334 extras_tigergeocoder.xml:374 extras_tigergeocoder.xml:418 extras_tigergeocoder.xml:476 extras_tigergeocoder.xml:534 extras_tigergeocoder.xml:588 extras_tigergeocoder.xml:633 extras_tigergeocoder.xml:712 extras_tigergeocoder.xml:798 extras_tigergeocoder.xml:841 extras_tigergeocoder.xml:913 extras_tigergeocoder.xml:981 extras_tigergeocoder.xml:1021 #, no-c-format msgid "See Also" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:89 extras_tigergeocoder.xml:417 +#: extras_tigergeocoder.xml:90 extras_tigergeocoder.xml:419 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:95 +#: extras_tigergeocoder.xml:96 #, no-c-format msgid "Drop_Nation_Tables_Generate_Script" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:97 +#: extras_tigergeocoder.xml:98 #, no-c-format msgid "Generates a script that drops all tables in the specified schema that start with county_all, state_all or stae code followed by county or state." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:102 +#: extras_tigergeocoder.xml:103 #, no-c-format msgid "text Drop_Nation_Tables_Generate_Script text param_schema=tiger_data" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:112 +#: extras_tigergeocoder.xml:113 #, no-c-format msgid "Generates a script that drops all tables in the specified schema that start with county_all, state_all or stae code followed by county or state. This is needed if you are upgrading from tiger_2010 to tiger_2011 data." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:115 extras_tigergeocoder.xml:320 extras_tigergeocoder.xml:571 extras_tigergeocoder.xml:742 extras_tigergeocoder.xml:1006 +#: extras_tigergeocoder.xml:116 extras_tigergeocoder.xml:322 extras_tigergeocoder.xml:573 extras_tigergeocoder.xml:744 extras_tigergeocoder.xml:1008 #, no-c-format msgid "Availability: 2.1.0" msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:123 +#: extras_tigergeocoder.xml:124 #, no-c-format msgid "" "SELECT drop_nation_tables_generate_script();\n" @@ -277,31 +283,31 @@ msgid "" msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:136 +#: extras_tigergeocoder.xml:137 #, no-c-format msgid "Drop_State_Tables_Generate_Script" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:138 +#: extras_tigergeocoder.xml:139 #, no-c-format msgid "Generates a script that drops all tables in the specified schema that are prefixed with the state abbreviation. Defaults schema to tiger_data if no schema is specified." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:143 +#: extras_tigergeocoder.xml:144 #, no-c-format msgid "text Drop_State_Tables_Generate_Script text param_state text param_schema=tiger_data" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:154 +#: extras_tigergeocoder.xml:155 #, no-c-format msgid "Generates a script that drops all tables in the specified schema that are prefixed with the state abbreviation. Defaults schema to tiger_data if no schema is specified. This function is useful for dropping tables of a state just before you reload a state in case something went wrong during your previous load." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:166 +#: extras_tigergeocoder.xml:167 #, no-c-format msgid "" "SELECT drop_state_tables_generate_script('PA');\n" @@ -320,116 +326,116 @@ msgid "" msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:178 +#: extras_tigergeocoder.xml:179 #, no-c-format msgid "Geocode" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:180 +#: extras_tigergeocoder.xml:181 #, no-c-format msgid "Takes in an address as a string (or other normalized address) and outputs a set of possible locations which include a point geometry in NAD 83 long lat, a normalized address for each, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Can optionally pass in maximum results, defaults to 10, and restrict_region (defaults to NULL)" msgstr "" #. Tag: funcsynopsis -#: extras_tigergeocoder.xml:185 +#: extras_tigergeocoder.xml:186 #, no-c-format msgid " setof record geocode varchar address integer max_results=10 geometry restrict_region=NULL norm_addy OUT addy geometry OUT geomout integer OUT rating setof record geocode norm_addy in_addy integer max_results=10 geometry restrict_region=NULL norm_addy OUT addy geometry OUT geomout integer OUT rating " msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:210 +#: extras_tigergeocoder.xml:211 #, no-c-format msgid "Takes in an address as a string (or already normalized address) and outputs a set of possible locations which include a point geometry in NAD 83 long lat, a normalized_address (addy) for each, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Uses Tiger data (edges,faces,addr), PostgreSQL fuzzy string matching (soundex,levenshtein) and PostGIS line interpolation functions to interpolate address along the Tiger edges. The higher the rating the less likely the geocode is right. The geocoded point is defaulted to offset 10 meters from center-line off to side (L/R) of street address is located on." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:214 +#: extras_tigergeocoder.xml:215 #, no-c-format msgid "Enhanced: 2.0.0 to support Tiger 2010 structured data and revised some logic to improve speed, accuracy of geocoding, and to offset point from centerline to side of street address is located on. New parameter max_results useful for specifying ot just return the best result." msgstr "" #. Tag: title -#: extras_tigergeocoder.xml:220 extras_tigergeocoder.xml:283 extras_tigergeocoder.xml:365 +#: extras_tigergeocoder.xml:221 extras_tigergeocoder.xml:284 extras_tigergeocoder.xml:367 #, no-c-format msgid "Examples: Basic" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:221 +#: extras_tigergeocoder.xml:222 #, no-c-format msgid "The below examples timings are on a 3.0 GHZ single processor Windows 7 machine with 2GB ram running PostgreSQL 9.1rc1/PostGIS 2.0 loaded with all of MA,MN,CA, RI state Tiger data loaded." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:222 +#: extras_tigergeocoder.xml:223 #, no-c-format msgid "Exact matches are faster to compute (61ms)" msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:223 +#: extras_tigergeocoder.xml:224 #, no-c-format msgid "" "SELECT g.rating, ST_X(g.geomout) As lon, ST_Y(g.geomout) As lat, \n" - " (addy).address As stno, (addy).streetname As street, \n" - " (addy).streettypeabbrev As styp, (addy).location As city, (addy).stateabbrev As st,(addy).zip \n" - " FROM geocode('75 State Street, Boston MA 02109') As g; \n" + " (addy).address As stno, (addy).streetname As street, \n" + " (addy).streettypeabbrev As styp, (addy).location As city, (addy).stateabbrev As st,(addy).zip \n" + " FROM geocode('75 State Street, Boston MA 02109') As g; \n" " rating | lon | lat | stno | street | styp | city | st | zip \n" "--------+-------------------+------------------+------+--------+------+--------+----+-------\n" " 0 | -71.0556722990239 | 42.3589914927049 | 75 | State | St | Boston | MA | 02109" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:224 +#: extras_tigergeocoder.xml:225 #, no-c-format msgid "Even if zip is not passed in the geocoder can guess (took about 122-150 ms)" msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:225 +#: extras_tigergeocoder.xml:226 #, no-c-format msgid "" "SELECT g.rating, ST_AsText(ST_SnapToGrid(g.geomout,0.00001)) As wktlonlat, \n" - " (addy).address As stno, (addy).streetname As street, \n" - " (addy).streettypeabbrev As styp, (addy).location As city, (addy).stateabbrev As st,(addy).zip \n" - " FROM geocode('226 Hanover Street, Boston, MA',1) As g; \n" + " (addy).address As stno, (addy).streetname As street, \n" + " (addy).streettypeabbrev As styp, (addy).location As city, (addy).stateabbrev As st,(addy).zip \n" + " FROM geocode('226 Hanover Street, Boston, MA',1) As g; \n" " rating | wktlonlat | stno | street | styp | city | st | zip \n" "--------+---------------------------+------+---------+------+--------+----+-------\n" " 1 | POINT(-71.05528 42.36316) | 226 | Hanover | St | Boston | MA | 02113" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:226 +#: extras_tigergeocoder.xml:227 #, no-c-format msgid "Can handle misspellings and provides more than one possible solution with ratings and takes longer (500ms)." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:227 +#: extras_tigergeocoder.xml:228 #, no-c-format msgid "" "SELECT g.rating, ST_AsText(ST_SnapToGrid(g.geomout,0.00001)) As wktlonlat, \n" " (addy).address As stno, (addy).streetname As street, \n" - " (addy).streettypeabbrev As styp, (addy).location As city, (addy).stateabbrev As st,(addy).zip \n" - " FROM geocode('31 - 37 Stewart Street, Boston, MA 02116') As g; \n" + " (addy).streettypeabbrev As styp, (addy).location As city, (addy).stateabbrev As st,(addy).zip \n" + " FROM geocode('31 - 37 Stewart Street, Boston, MA 02116') As g; \n" " rating | wktlonlat | stno | street | styp | city | st | zip \n" "--------+---------------------------+------+--------+------+--------+----+-------\n" " 70 | POINT(-71.06459 42.35113) | 31 | Stuart | St | Boston | MA | 02116" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:229 +#: extras_tigergeocoder.xml:230 #, no-c-format msgid "Using to do a batch geocode of addresses. Easiest is to set max_results=1. Only process those not yet geocoded (have no rating)." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:230 +#: extras_tigergeocoder.xml:231 #, no-c-format msgid "" "CREATE TABLE addresses_to_geocode(addid serial PRIMARY KEY, address text,\n" - " lon numeric, lat numeric, new_address text, rating integer);\n" + " lon numeric, lat numeric, new_address text, rating integer);\n" "\n" "INSERT INTO addresses_to_geocode(address)\n" "VALUES ('529 Main Street, Boston MA, 02129'),\n" @@ -447,14 +453,14 @@ msgid "" "-- to ensure we don't regeocode a bad address \n" "UPDATE addresses_to_geocode\n" " SET (rating, new_address, lon, lat) \n" - " = ( COALESCE((g.geo).rating,-1), pprint_addy((g.geo).addy),\n" - " ST_X((g.geo).geomout)::numeric(8,5), ST_Y((g.geo).geomout)::numeric(8,5) )\n" + " = ( COALESCE((g.geo).rating,-1), pprint_addy((g.geo).addy),\n" + " ST_X((g.geo).geomout)::numeric(8,5), ST_Y((g.geo).geomout)::numeric(8,5) )\n" "FROM (SELECT addid \n" - " FROM addresses_to_geocode \n" - " WHERE rating IS NULL ORDER BY addid LIMIT 3) As a\n" - " LEFT JOIN (SELECT addid, (geocode(address,1)) As geo\n" + " FROM addresses_to_geocode \n" + " WHERE rating IS NULL ORDER BY addid LIMIT 3) As a\n" + " LEFT JOIN (SELECT addid, (geocode(address,1)) As geo\n" " FROM addresses_to_geocode As ag\n" - " WHERE ag.rating IS NULL ORDER BY addid LIMIT 3) As g ON a.addid = g.addid\n" + " WHERE ag.rating IS NULL ORDER BY addid LIMIT 3) As g ON a.addid = g.addid\n" "WHERE a.addid = addresses_to_geocode.addid;\n" "\n" "result\n" @@ -471,24 +477,24 @@ msgid "" msgstr "" #. Tag: title -#: extras_tigergeocoder.xml:233 +#: extras_tigergeocoder.xml:234 #, no-c-format msgid "Examples: Using Geometry filter" msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:234 +#: extras_tigergeocoder.xml:235 #, no-c-format msgid "" "SELECT g.rating, ST_AsText(ST_SnapToGrid(g.geomout,0.00001)) As wktlonlat, \n" " (addy).address As stno, (addy).streetname As street, \n" - " (addy).streettypeabbrev As styp, \n" - " (addy).location As city, (addy).stateabbrev As st,(addy).zip \n" + " (addy).streettypeabbrev As styp, \n" + " (addy).location As city, (addy).stateabbrev As st,(addy).zip \n" " FROM geocode('100 Federal Street, MA',\n" - " 3, \n" - " (SELECT ST_Union(the_geom) \n" - " FROM place WHERE statefp = '25' AND name = 'Lynn')::geometry\n" - " ) As g;\n" + " 3, \n" + " (SELECT ST_Union(the_geom) \n" + " FROM place WHERE statefp = '25' AND name = 'Lynn')::geometry\n" + " ) As g;\n" "\n" " rating | wktlonlat | stno | street | styp | city | st | zip\n" "--------+--------------------------+------+---------+------+------+----+-------\n" @@ -497,70 +503,70 @@ msgid "" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:240 +#: extras_tigergeocoder.xml:241 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:246 +#: extras_tigergeocoder.xml:247 #, no-c-format msgid "Geocode_Intersection" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:248 +#: extras_tigergeocoder.xml:249 #, no-c-format msgid "Takes in 2 streets that intersect and a state, city, zip, and outputs a set of possible locations on the first cross street that is at the intersection, also includes a point geometry in NAD 83 long lat, a normalized address for each location, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Can optionally pass in maximum results, defaults to 10" msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:254 +#: extras_tigergeocoder.xml:255 #, no-c-format msgid "setof record geocode_intersection text roadway1 text roadway2 text in_state text in_city text in_zip integer max_results=10 norm_addy OUT addy geometry OUT geomout integer OUT rating" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:272 +#: extras_tigergeocoder.xml:273 #, no-c-format msgid "Takes in 2 streets that intersect and a state, city, zip, and outputs a set of possible locations on the first cross street that is at the intersection, also includes a point geometry in NAD 83 long lat, a normalized address for each location, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Can optionally pass in maximum results, defaults to 10. Returns normalized_address (addy) for each, geomout as the point location in nad 83 long lat, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Uses Tiger data (edges,faces,addr), PostgreSQL fuzzy string matching (soundex,levenshtein)" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:284 +#: extras_tigergeocoder.xml:285 #, no-c-format msgid "The below examples timings are on a 3.0 GHZ single processor Windows 7 machine with 2GB ram running PostgreSQL 9.0/PostGIS 1.5 loaded with all of MA state Tiger data loaded. Currently a bit slow (3000 ms)" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:285 +#: extras_tigergeocoder.xml:286 #, no-c-format msgid "Testing on Windows 2003 64-bit 8GB on PostGIS 2.0 PostgreSQL 64-bit Tiger 2011 data loaded -- (41ms)" msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:286 +#: extras_tigergeocoder.xml:287 #, no-c-format msgid "" "SELECT pprint_addy(addy), st_astext(geomout),rating \n" - " FROM geocode_intersection( 'Haverford St','Germania St', 'MA', 'Boston', '02130',1); \n" + " FROM geocode_intersection( 'Haverford St','Germania St', 'MA', 'Boston', '02130',1); \n" " pprint_addy | st_astext | rating\n" "----------------------------------+----------------------------+--------\n" "98 Haverford St, Boston, MA 02130 | POINT(-71.101375 42.31376) | 0" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:287 +#: extras_tigergeocoder.xml:288 #, no-c-format msgid "Even if zip is not passed in the geocoder can guess (took about 3500 ms on the windows 7 box), on the windows 2003 64-bit 741 ms" msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:288 +#: extras_tigergeocoder.xml:289 #, no-c-format msgid "" "SELECT pprint_addy(addy), st_astext(geomout),rating \n" - " FROM geocode_intersection('Weld', 'School', 'MA', 'Boston');\n" + " FROM geocode_intersection('Weld', 'School', 'MA', 'Boston');\n" " pprint_addy | st_astext | rating\n" "-------------------------------+--------------------------+--------\n" " 98 Weld Ave, Boston, MA 02119 | POINT(-71.099 42.314234) | 3\n" @@ -568,60 +574,65 @@ msgid "" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:294 +#: extras_tigergeocoder.xml:295 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:300 +#: extras_tigergeocoder.xml:301 #, no-c-format msgid "Get_Geocode_Setting" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:302 +#: extras_tigergeocoder.xml:303 #, no-c-format msgid "Returns value of specific setting stored in tiger.geocode_settings table." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:307 +#: extras_tigergeocoder.xml:308 #, no-c-format msgid "text Get_Geocode_Setting text setting_name" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:317 +#: extras_tigergeocoder.xml:318 #, no-c-format msgid "Returns value of specific setting stored in tiger.geocode_settings table. Settings allow you to toggle debugging of functions. Later plans will be to control rating with settings. Current list of settings are as follows:" msgstr "" #. Tag: screen -#: extras_tigergeocoder.xml:318 +#: extras_tigergeocoder.xml:319 #, no-c-format msgid "" "name | setting | unit | category | short_desc\n" - "--------------------------------+---------+---------+-----------+------------------------------------------------------------------------------------------------------\n" + "--------------------------------+---------+---------+-----------+------------------------------------------------------------------------------------------------------------------------------\n" " debug_geocode_address | false | boolean | debug | outputs debug information in notice log such as queries when geocode_addresss is called if true\n" " debug_geocode_intersection | false | boolean | debug | outputs debug information in notice log such as queries when geocode_intersection is called if true\n" - " debug_normalize_address | false | boolean | debug | outputs debug information in notice log such as queries \n" - " | | | | and intermediate expressions when normalize_address is called if true\n" - " debug_reverse_geocode | false | boolean | debug | if true, outputs debug information in notice log such as queries \n" - " | and intermediate expressions when reverse_geocode\n" - " reverse_geocode_numbered_roads | 0 | integer | rating | For state and county highways, 0 - no preference in name\n" - " | | | | , 1 - prefer the numbered highway name, 2 - prefer local state/county name\n" - " use_pagc_address_parser | false | boolean | normalize | If set to true, will try to use the pagc_address normalizer instead of tiger built one" + " debug_normalize_address | false | boolean | debug | outputs debug information in notice log such as queries and intermediate expressions when normalize_address is called if true\n" + " debug_reverse_geocode | false | boolean | debug | if true, outputs debug information in notice log such as queries and intermediate expressions when reverse_geocode\n" + " reverse_geocode_numbered_roads | 0 | integer | rating | For state and county highways, 0 - no preference in name, \n" + " 1 - prefer the numbered highway name, 2 - prefer local state/county name\n" + " use_pagc_address_parser | false | boolean | normalize | If set to true, will try to use the address_standardizer extension (via pagc_normalize_address) \n" + " instead of tiger normalize_address built one" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:321 +#, no-c-format +msgid "Changed: 2.2.0 : default settings are now kept in a table called geocode_settings_default. Use customized settingsa re in geocode_settings and only contain those that have been set by user." msgstr "" #. Tag: title -#: extras_tigergeocoder.xml:326 extras_tigergeocoder.xml:1012 +#: extras_tigergeocoder.xml:328 extras_tigergeocoder.xml:1014 #, no-c-format msgid "Example return debugging setting" msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:327 +#: extras_tigergeocoder.xml:329 #, no-c-format msgid "" "SELECT get_geocode_setting('debug_geocode_address) As result;\n" @@ -631,31 +642,31 @@ msgid "" msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:339 +#: extras_tigergeocoder.xml:341 #, no-c-format msgid "Get_Tract" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:341 +#: extras_tigergeocoder.xml:343 #, no-c-format msgid "Returns census tract or field from tract table of where the geometry is located. Default to returning short name of tract." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:346 +#: extras_tigergeocoder.xml:348 #, no-c-format msgid "text get_tract geometry loc_geom text output_field=name" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:357 +#: extras_tigergeocoder.xml:359 #, no-c-format msgid "Given a geometry will return the census tract location of that geometry. NAD 83 long lat is assumed if no spatial ref sys is specified." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:366 +#: extras_tigergeocoder.xml:368 #, no-c-format msgid "" "SELECT get_tract(ST_Point(-71.101375, 42.31376) ) As tract_name;\n" @@ -665,7 +676,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:367 +#: extras_tigergeocoder.xml:369 #, no-c-format msgid "" "--this one returns the tiger geoid\n" @@ -676,113 +687,113 @@ msgid "" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:373 +#: extras_tigergeocoder.xml:375 #, no-c-format msgid ">" msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:379 +#: extras_tigergeocoder.xml:381 #, no-c-format msgid "Install_Missing_Indexes" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:381 +#: extras_tigergeocoder.xml:383 #, no-c-format msgid "Finds all tables with key columns used in geocoder joins and filter conditions that are missing used indexes on those columns and will add them." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:386 +#: extras_tigergeocoder.xml:388 #, no-c-format msgid "boolean Install_Missing_Indexes " msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:396 +#: extras_tigergeocoder.xml:398 #, no-c-format msgid "Finds all tables in tiger and tiger_data schemas with key columns used in geocoder joins and filters that are missing indexes on those columns and will output the SQL DDL to define the index for those tables and then execute the generated script. This is a helper function that adds new indexes needed to make queries faster that may have been missing during the load process. This function is a companion to that in addition to generating the create index script, also executes it. It is called as part of the update_geocode.sql upgrade script." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:410 +#: extras_tigergeocoder.xml:412 #, no-c-format msgid "" "SELECT install_missing_indexes();\n" - " install_missing_indexes\n" + " install_missing_indexes\n" "-------------------------\n" " t" msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:423 +#: extras_tigergeocoder.xml:425 #, no-c-format msgid "Loader_Generate_Census_Script" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:425 +#: extras_tigergeocoder.xml:427 #, no-c-format msgid "Generates a shell script for the specified platform for the specified states that will download Tiger census state tract, bg, and tabblocks data tables, stage and load into tiger_data schema. Each state script is returned as a separate record." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:430 +#: extras_tigergeocoder.xml:432 #, no-c-format msgid "setof text loader_generate_census_script text[] param_states text os" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:441 +#: extras_tigergeocoder.xml:443 #, no-c-format msgid "Generates a shell script for the specified platform for the specified states that will download Tiger data census state tract, block groups bg, and tabblocks data tables, stage and load into tiger_data schema. Each state script is returned as a separate record." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:442 +#: extras_tigergeocoder.xml:444 #, no-c-format msgid "It uses unzip on Linux (7-zip on Windows by default) and wget to do the downloading. It uses to load in the data. Note the smallest unit it does is a whole state. It will only process the files in the staging and temp folders." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:444 extras_tigergeocoder.xml:502 +#: extras_tigergeocoder.xml:446 extras_tigergeocoder.xml:504 #, no-c-format msgid "It uses the following control tables to control the process and different OS shell syntax variations." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:448 extras_tigergeocoder.xml:506 extras_tigergeocoder.xml:562 +#: extras_tigergeocoder.xml:450 extras_tigergeocoder.xml:508 extras_tigergeocoder.xml:564 #, no-c-format msgid "loader_variables keeps track of various variables such as census site, year, data and staging schemas" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:451 extras_tigergeocoder.xml:509 +#: extras_tigergeocoder.xml:453 extras_tigergeocoder.xml:511 #, no-c-format msgid "loader_platform profiles of various platforms and where the various executables are located. Comes with windows and linux. More can be added." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:454 extras_tigergeocoder.xml:512 extras_tigergeocoder.xml:568 +#: extras_tigergeocoder.xml:456 extras_tigergeocoder.xml:514 extras_tigergeocoder.xml:570 #, no-c-format msgid "loader_lookuptables each record defines a kind of table (state, county), whether to process records in it and how to load them in. Defines the steps to import data, stage data, add, removes columns, indexes, and constraints for each. Each table is prefixed with the state and inherits from a table in the tiger schema. e.g. creates tiger_data.ma_faces which inherits from tiger.faces" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:458 +#: extras_tigergeocoder.xml:460 #, no-c-format msgid "includes this logic, but if you installed tiger geocoder prior to PostGIS 2.0.0 alpha5, you'll need to run this on the states you have already done to get these additional tables." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:465 +#: extras_tigergeocoder.xml:467 #, no-c-format msgid "Generate script to load up data for select states in Windows shell script format." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:466 +#: extras_tigergeocoder.xml:468 #, no-c-format msgid "" "SELECT loader_generate_census_script(ARRAY['MA'], 'windows');\n" @@ -807,7 +818,7 @@ msgid "" "%PSQL% -c \"CREATE SCHEMA tiger_staging;\"\n" "cd %STATEDIR%\n" "for /r %%z in (*.zip) do %UNZIPTOOL% e %%z -o%TMPDIR% \n" - "cd %TMPDIR% \n" + "cd %TMPDIR% \n" "%PSQL% -c \"CREATE TABLE tiger_data.MA_tract(CONSTRAINT pk_MA_tract PRIMARY KEY (tract_id) ) INHERITS(tiger.tract); \" \n" "%SHP2PGSQL% -c -s 4269 -g the_geom -W \"latin1\" tl_2010_25_tract10.dbf tiger_staging.ma_tract10 | %PSQL%\n" "%PSQL% -c \"ALTER TABLE tiger_staging.MA_tract10 RENAME geoid10 TO tract_id; SELECT loader_load_staged_data(lower('MA_tract10'), lower('MA_tract')); \"\n" @@ -818,13 +829,13 @@ msgid "" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:467 extras_tigergeocoder.xml:525 +#: extras_tigergeocoder.xml:469 extras_tigergeocoder.xml:527 #, no-c-format msgid "Generate sh script" msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:468 +#: extras_tigergeocoder.xml:470 #, no-c-format msgid "" "STATEDIR=\"/gisdata/www2.census.gov/geo/pvs/tiger2010st/25_Massachusetts\" \n" @@ -852,49 +863,49 @@ msgid "" msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:481 +#: extras_tigergeocoder.xml:483 #, no-c-format msgid "Loader_Generate_Script" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:483 +#: extras_tigergeocoder.xml:485 #, no-c-format msgid "Generates a shell script for the specified platform for the specified states that will download Tiger data, stage and load into tiger_data schema. Each state script is returned as a separate record. Latest version supports Tiger 2010 structural changes and also loads census tract, block groups, and blocks tables." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:488 +#: extras_tigergeocoder.xml:490 #, no-c-format msgid "setof text loader_generate_script text[] param_states text os" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:499 +#: extras_tigergeocoder.xml:501 #, no-c-format msgid "Generates a shell script for the specified platform for the specified states that will download Tiger data, stage and load into tiger_data schema. Each state script is returned as a separate record." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:500 +#: extras_tigergeocoder.xml:502 #, no-c-format msgid "It uses unzip on Linux (7-zip on Windows by default) and wget to do the downloading. It uses to load in the data. Note the smallest unit it does is a whole state, but you can overwrite this by downloading the files yourself. It will only process the files in the staging and temp folders." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:515 +#: extras_tigergeocoder.xml:517 #, no-c-format msgid "Availability: 2.0.0 to support Tiger 2010 structured data and load census tract (tract), block groups (bg), and blocks (tabblocks) tables ." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:523 +#: extras_tigergeocoder.xml:525 #, no-c-format msgid "Generate script to load up data for 2 states in Windows shell script format." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:524 +#: extras_tigergeocoder.xml:526 #, no-c-format msgid "" "SELECT loader_generate_script(ARRAY['MA','RI'], 'windows') AS result;\n" @@ -918,7 +929,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:526 +#: extras_tigergeocoder.xml:528 #, no-c-format msgid "" "SELECT loader_generate_script(ARRAY['MA','RI'], 'sh') AS result;\n" @@ -940,103 +951,103 @@ msgid "" msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:539 +#: extras_tigergeocoder.xml:541 #, no-c-format msgid "Loader_Generate_Nation_Script" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:541 +#: extras_tigergeocoder.xml:543 #, no-c-format msgid "Generates a shell script for the specified platform that loads in the county and state lookup tables." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:546 +#: extras_tigergeocoder.xml:548 #, no-c-format msgid "text loader_generate_nation_script text os" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:556 +#: extras_tigergeocoder.xml:558 #, no-c-format msgid "Generates a shell script for the specified platform that loads in the county_all, county_all_lookup, state_all tables into tiger_data schema. These inherit respectively from the county, county_lookup, state tables in tiger schema." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:557 +#: extras_tigergeocoder.xml:559 #, no-c-format msgid "It uses unzip on Linux (7-zip on Windows by default) and wget to do the downloading. It uses to load in the data." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:558 +#: extras_tigergeocoder.xml:560 #, no-c-format msgid "It uses the following control tables tiger.loader_platform, tiger.loader_variables, and tiger.loader_lookuptables to control the process and different OS shell syntax variations." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:565 +#: extras_tigergeocoder.xml:567 #, no-c-format msgid "loader_platform profiles of various platforms and where the various executables are located. Comes with windows and linux/unix. More can be added." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:572 +#: extras_tigergeocoder.xml:574 #, no-c-format msgid "If you were running tiger_2010 version and you want to reload as state with tiger_2011, you'll need to for the very first load generate and run drop statements before you run this script." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:578 +#: extras_tigergeocoder.xml:580 #, no-c-format msgid "Generate script script to load nation data Windows." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:579 +#: extras_tigergeocoder.xml:581 #, no-c-format msgid "SELECT loader_generate_nation_script('windows');" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:580 +#: extras_tigergeocoder.xml:582 #, no-c-format msgid "Generate script to load up data for Linux/Unix systems." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:581 +#: extras_tigergeocoder.xml:583 #, no-c-format msgid "SELECT loader_generate_nation_script('sh');" msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:593 +#: extras_tigergeocoder.xml:595 #, no-c-format msgid "Missing_Indexes_Generate_Script" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:595 +#: extras_tigergeocoder.xml:597 #, no-c-format msgid "Finds all tables with key columns used in geocoder joins that are missing indexes on those columns and will output the SQL DDL to define the index for those tables." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:601 +#: extras_tigergeocoder.xml:603 #, no-c-format msgid "text Missing_Indexes_Generate_Script " msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:611 +#: extras_tigergeocoder.xml:613 #, no-c-format msgid "Finds all tables in tiger and tiger_data schemas with key columns used in geocoder joins that are missing indexes on those columns and will output the SQL DDL to define the index for those tables. This is a helper function that adds new indexes needed to make queries faster that may have been missing during the load process. As the geocoder is improved, this function will be updated to accommodate new indexes being used. If this function outputs nothing, it means all your tables have what we think are the key indexes already in place." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:625 +#: extras_tigergeocoder.xml:627 #, no-c-format msgid "" "SELECT missing_indexes_generate_script();\n" @@ -1053,127 +1064,127 @@ msgid "" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:632 +#: extras_tigergeocoder.xml:634 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:638 +#: extras_tigergeocoder.xml:640 #, no-c-format msgid "Normalize_Address" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:640 +#: extras_tigergeocoder.xml:642 #, no-c-format msgid "Given a textual street address, returns a composite norm_addy type that has road suffix, prefix and type standardized, street, streetname etc. broken into separate fields. This function will work with just the lookup data packaged with the tiger_geocoder (no need for tiger census data)." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:646 +#: extras_tigergeocoder.xml:648 #, no-c-format msgid "norm_addy normalize_address varchar in_address" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:656 extras_tigergeocoder.xml:735 +#: extras_tigergeocoder.xml:658 extras_tigergeocoder.xml:737 #, no-c-format msgid "Given a textual street address, returns a composite norm_addy type that has road suffix, prefix and type standardized, street, streetname etc. broken into separate fields. This is the first step in the geocoding process to get all addresses into normalized postal form. No other data is required aside from what is packaged with the geocoder." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:658 +#: extras_tigergeocoder.xml:660 #, no-c-format msgid "This function just uses the various direction/state/suffix lookup tables preloaded with the tiger_geocoder and located in the tiger schema, so it doesn't need you to download tiger census data or any other additional data to make use of it. You may find the need to add more abbreviations or alternative namings to the various lookup tables in the tiger schema." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:660 extras_tigergeocoder.xml:739 +#: extras_tigergeocoder.xml:662 extras_tigergeocoder.xml:741 #, no-c-format msgid "It uses various control lookup tables located in tiger schema to normalize the input address." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:661 extras_tigergeocoder.xml:740 +#: extras_tigergeocoder.xml:663 extras_tigergeocoder.xml:742 #, no-c-format msgid "Fields in the norm_addy type object returned by this function in this order where () indicates a field required by the geocoder, [] indicates an optional field:" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:662 extras_tigergeocoder.xml:744 +#: extras_tigergeocoder.xml:664 extras_tigergeocoder.xml:746 #, no-c-format msgid "(address) [predirAbbrev] (streetName) [streetTypeAbbrev] [postdirAbbrev] [internal] [location] [stateAbbrev] [zip]" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:665 extras_tigergeocoder.xml:750 +#: extras_tigergeocoder.xml:667 extras_tigergeocoder.xml:752 #, no-c-format msgid "address is an integer: The street number" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:668 extras_tigergeocoder.xml:753 +#: extras_tigergeocoder.xml:670 extras_tigergeocoder.xml:755 #, no-c-format msgid "predirAbbrev is varchar: Directional prefix of road such as N, S, E, W etc. These are controlled using the direction_lookup table." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:671 extras_tigergeocoder.xml:756 +#: extras_tigergeocoder.xml:673 extras_tigergeocoder.xml:758 #, no-c-format msgid "streetName varchar" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:674 extras_tigergeocoder.xml:759 +#: extras_tigergeocoder.xml:676 extras_tigergeocoder.xml:761 #, no-c-format msgid "streetTypeAbbrev varchar abbreviated version of street type: e.g. St, Ave, Cir. These are controlled using the street_type_lookup table." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:677 extras_tigergeocoder.xml:762 +#: extras_tigergeocoder.xml:679 extras_tigergeocoder.xml:764 #, no-c-format msgid "postdirAbbrev varchar abbreviated directional suffice of road N, S, E, W etc. These are controlled using the direction_lookup table." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:680 extras_tigergeocoder.xml:765 +#: extras_tigergeocoder.xml:682 extras_tigergeocoder.xml:767 #, no-c-format msgid "internal varchar internal address such as an apartment or suite number." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:683 extras_tigergeocoder.xml:768 +#: extras_tigergeocoder.xml:685 extras_tigergeocoder.xml:770 #, no-c-format msgid "location varchar usually a city or governing province." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:686 extras_tigergeocoder.xml:771 +#: extras_tigergeocoder.xml:688 extras_tigergeocoder.xml:773 #, no-c-format msgid "stateAbbrev varchar two character US State. e.g MA, NY, MI. These are controlled by the state_lookup table." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:689 extras_tigergeocoder.xml:774 +#: extras_tigergeocoder.xml:691 extras_tigergeocoder.xml:776 #, no-c-format msgid "zip varchar 5-digit zipcode. e.g. 02109." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:692 extras_tigergeocoder.xml:777 +#: extras_tigergeocoder.xml:694 extras_tigergeocoder.xml:779 #, no-c-format msgid "parsed boolean - denotes if addess was formed from normalize process. The normalize_address function sets this to true before returning the address." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:701 +#: extras_tigergeocoder.xml:703 #, no-c-format msgid "Output select fields. Use if you want a pretty textual output." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:702 +#: extras_tigergeocoder.xml:704 #, no-c-format msgid "" "SELECT address As orig, (g.na).streetname, (g.na).streettypeabbrev\n" @@ -1191,67 +1202,67 @@ msgid "" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:711 +#: extras_tigergeocoder.xml:713 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:717 +#: extras_tigergeocoder.xml:719 #, no-c-format msgid "Pagc_Normalize_Address" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:719 +#: extras_tigergeocoder.xml:721 #, no-c-format msgid "Given a textual street address, returns a composite norm_addy type that has road suffix, prefix and type standardized, street, streetname etc. broken into separate fields. This function will work with just the lookup data packaged with the tiger_geocoder (no need for tiger census data). Requires address_standardizer extension." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:725 +#: extras_tigergeocoder.xml:727 #, no-c-format msgid "norm_addy pagc_normalize_address varchar in_address" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:737 +#: extras_tigergeocoder.xml:739 #, no-c-format msgid "This function just uses the various pagc_* lookup tables preloaded with the tiger_geocoder and located in the tiger schema, so it doesn't need you to download tiger census data or any other additional data to make use of it. You may find the need to add more abbreviations or alternative namings to the various lookup tables in the tiger schema." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:741 +#: extras_tigergeocoder.xml:743 #, no-c-format msgid "There are slight variations in casing and formatting over the ." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:743 +#: extras_tigergeocoder.xml:745 #, no-c-format msgid "&address_standardizer_required;" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:745 +#: extras_tigergeocoder.xml:747 #, no-c-format msgid "The native standardaddr of address_standardizer extension is at this time a bit richer than norm_addy since its designed to support international addresses (including country). standardaddr equivalent fields are:" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:746 +#: extras_tigergeocoder.xml:748 #, no-c-format msgid "house_num,predir, name, suftype, sufdir, unit, city, state, postcode" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:785 +#: extras_tigergeocoder.xml:787 #, no-c-format msgid "Single call example" msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:786 +#: extras_tigergeocoder.xml:788 #, no-c-format msgid "" "SELECT addy.*\n" @@ -1264,13 +1275,13 @@ msgid "" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:788 +#: extras_tigergeocoder.xml:790 #, no-c-format msgid "Batch call. There are currently speed issues with the way postgis_tiger_geocoder wraps the address_standardizer. These will hopefully be resolved in later editions. To work around them, if you need speed for batch geocoding to call generate a normaddy in batch mode, you are encouraged to directly call the address_standardizer standardize_address function as shown below which is similar exercise to what we did in that uses data created in ." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:792 +#: extras_tigergeocoder.xml:794 #, no-c-format msgid "" "WITH g AS (SELECT address, ROW((sa).house_num, (sa).predir, (sa).name\n" @@ -1293,49 +1304,49 @@ msgid "" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:797 extras_tigergeocoder.xml:913 +#: extras_tigergeocoder.xml:799 extras_tigergeocoder.xml:915 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:803 +#: extras_tigergeocoder.xml:805 #, no-c-format msgid "Pprint_Addy" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:805 +#: extras_tigergeocoder.xml:807 #, no-c-format msgid "Given a norm_addy composite type object, returns a pretty print representation of it. Usually used in conjunction with normalize_address." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:810 +#: extras_tigergeocoder.xml:812 #, no-c-format msgid "varchar pprint_addy norm_addy in_addy" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:820 +#: extras_tigergeocoder.xml:822 #, no-c-format msgid "Given a norm_addy composite type object, returns a pretty print representation of it. No other data is required aside from what is packaged with the geocoder." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:821 +#: extras_tigergeocoder.xml:823 #, no-c-format msgid "Usually used in conjunction with ." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:829 +#: extras_tigergeocoder.xml:831 #, no-c-format msgid "Pretty print a single address" msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:830 +#: extras_tigergeocoder.xml:832 #, no-c-format msgid "" "SELECT pprint_addy(normalize_address('202 East Fremont Street, Las Vegas, Nevada 89101')) As pretty_address;\n" @@ -1345,13 +1356,13 @@ msgid "" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:832 +#: extras_tigergeocoder.xml:834 #, no-c-format msgid "Pretty print address a table of addresses" msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:833 +#: extras_tigergeocoder.xml:835 #, no-c-format msgid "" "SELECT address As orig, pprint_addy(normalize_address(address)) As pretty_address\n" @@ -1367,77 +1378,77 @@ msgid "" msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:846 +#: extras_tigergeocoder.xml:848 #, no-c-format msgid "Reverse_Geocode" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:848 +#: extras_tigergeocoder.xml:850 #, no-c-format msgid "Takes a geometry point in a known spatial ref sys and returns a record containing an array of theoretically possible addresses and an array of cross streets. If include_strnum_range = true, includes the street range in the cross streets." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:853 +#: extras_tigergeocoder.xml:855 #, no-c-format msgid "record Reverse_Geocode geometry pt boolean include_strnum_range=false geometry[] OUT intpt norm_addy[] OUT addy varchar[] OUT street" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:867 +#: extras_tigergeocoder.xml:869 #, no-c-format msgid "Takes a geometry point in a known spatial ref and returns a record containing an array of theoretically possible addresses and an array of cross streets. If include_strnum_range = true, includes the street range in the cross streets. include_strnum_range defaults to false if not passed in. Addresses are sorted according to which road a point is closest to so first address is most likely the right one." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:870 +#: extras_tigergeocoder.xml:872 #, no-c-format msgid "Why do we say theoretical instead of actual addresses. The Tiger data doesn't have real addresses, but just street ranges. As such the theoretical address is an interpolated address based on the street ranges. Like for example interpolating one of my addresses returns a 26 Court St. and 26 Court Sq., though there is no such place as 26 Court Sq. This is because a point may be at a corner of 2 streets and thus the logic interpolates along both streets. The logic also assumes addresses are equally spaced along a street, which of course is wrong since you can have a municipal building taking up a good chunk of the street range and the rest of the buildings are clustered at the end." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:875 +#: extras_tigergeocoder.xml:877 #, no-c-format msgid "Note: Hmm this function relies on Tiger data. If you have not loaded data covering the region of this point, then hmm you will get a record filled with NULLS." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:876 +#: extras_tigergeocoder.xml:878 #, no-c-format msgid "Returned elements of the record are as follows:" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:879 +#: extras_tigergeocoder.xml:881 #, no-c-format msgid "intpt is an array of points: These are the center line points on the street closest to the input point. There are as many points as there are addresses." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:882 +#: extras_tigergeocoder.xml:884 #, no-c-format msgid "addy is an array of norm_addy (normalized addresses): These are an array of possible addresses that fit the input point. The first one in the array is most likely. Generally there should be only one, except in the case when a point is at the corner of 2 or 3 streets, or the point is somewhere on the road and not off to the side." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:886 +#: extras_tigergeocoder.xml:888 #, no-c-format msgid "street an array of varchar: These are cross streets (or the street) (streets that intersect or are the street the point is projected to be on)." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:897 +#: extras_tigergeocoder.xml:899 #, no-c-format msgid "Example of a point at the corner of two streets, but closest to one. This is approximate location of MIT: 77 Massachusetts Ave, Cambridge, MA 02139 Note that although we don't have 3 streets, PostgreSQL will just return null for entries above our upper bound so safe to use. This includes street ranges" msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:899 +#: extras_tigergeocoder.xml:901 #, no-c-format msgid "" "SELECT pprint_addy(r.addy[1]) As st1, pprint_addy(r.addy[2]) As st2, pprint_addy(r.addy[3]) As st3, \n" - " array_to_string(r.street, ',') As cross_streets \n" + " array_to_string(r.street, ',') As cross_streets \n" " FROM reverse_geocode(ST_GeomFromText('POINT(-71.093902 42.359446)',4269),true) As r;\n" " \n" " result\n" @@ -1448,13 +1459,13 @@ msgid "" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:901 +#: extras_tigergeocoder.xml:903 #, no-c-format msgid "Here we choose not to include the address ranges for the cross streets and picked a location really really close to a corner of 2 streets thus could be known by two different addresses." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:903 +#: extras_tigergeocoder.xml:905 #, no-c-format msgid "" "SELECT pprint_addy(r.addy[1]) As st1, pprint_addy(r.addy[2]) As st2, \n" @@ -1469,17 +1480,17 @@ msgid "" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:905 +#: extras_tigergeocoder.xml:907 #, no-c-format msgid "For this one we reuse our geocoded example from and we only want the primary address and at most 2 cross streets." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:906 +#: extras_tigergeocoder.xml:908 #, no-c-format msgid "" "SELECT actual_addr, lon, lat, pprint_addy((rg).addy[1]) As int_addr1, \n" - " (rg).street[1] As cross1, (rg).street[2] As cross2\n" + " (rg).street[1] As cross1, (rg).street[2] As cross2\n" "FROM (SELECT address As actual_addr, lon, lat,\n" " reverse_geocode( ST_SetSRID(ST_Point(lon,lat),4326) ) As rg\n" " FROM addresses_to_geocode WHERE rating > -1) As foo;\n" @@ -1494,85 +1505,85 @@ msgid "" msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:919 +#: extras_tigergeocoder.xml:921 #, no-c-format msgid "Topology_Load_Tiger" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:921 +#: extras_tigergeocoder.xml:923 #, no-c-format msgid "Loads a defined region of tiger data into a PostGIS Topology and transforming the tiger data to spatial reference of the topology and snapping to the precision tolerance of the topology." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:927 +#: extras_tigergeocoder.xml:929 #, no-c-format msgid "text Topology_Load_Tiger varchar topo_name varchar region_type varchar region_id" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:939 +#: extras_tigergeocoder.xml:941 #, no-c-format msgid "Loads a defined region of tiger data into a PostGIS Topology. The faces, nodes and edges are transformed to the spatial reference system of the target topology and points are snapped to the tolerance of the target topology. The created faces, nodes, edges maintain the same ids as the original Tiger data faces, nodes, edges so that datasets can be in the future be more easily reconciled with tiger data. Returns summary details about the process." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:942 +#: extras_tigergeocoder.xml:944 #, no-c-format msgid "This would be useful for example for redistricting data where you require the newly formed polygons to follow the center lines of streets and for the resulting polygons not to overlap." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:944 +#: extras_tigergeocoder.xml:946 #, no-c-format msgid "This function relies on Tiger data as well as the installation of the PostGIS topology module. For more information, refer to and . If you have not loaded data covering the region of interest, then no topology records will be created. This function will also fail if you have not created a topology using the topology functions." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:946 +#: extras_tigergeocoder.xml:948 #, no-c-format msgid "Most topology validation errors are a result of tolerance issues where after transformation the edges points don't quite line up or overlap. To remedy the situation you may want to increase or lower the precision if you get topology validation failures." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:948 +#: extras_tigergeocoder.xml:950 #, no-c-format msgid "Required arguments:" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:951 +#: extras_tigergeocoder.xml:953 #, no-c-format msgid "topo_name The name of an existing PostGIS topology to load data into." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:954 +#: extras_tigergeocoder.xml:956 #, no-c-format msgid "region_type The type of bounding region. Currently only place and county are supported. Plan is to have several more. This is the table to look into to define the region bounds. e.g tiger.place, tiger.county" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:957 +#: extras_tigergeocoder.xml:959 #, no-c-format msgid "region_id This is what TIGER calls the geoid. It is the unique identifier of the region in the table. For place it is the plcidfp column in tiger.place. For county it is the cntyidfp column in tiger.county" msgstr "" #. Tag: title -#: extras_tigergeocoder.xml:966 +#: extras_tigergeocoder.xml:968 #, no-c-format msgid "Example: Boston, Massachusetts Topology" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:967 +#: extras_tigergeocoder.xml:969 #, no-c-format msgid "Create a topology for Boston, Massachusetts in Mass State Plane Feet (2249) with tolerance 0.25 feet and then load in Boston city tiger faces, edges, nodes." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:969 +#: extras_tigergeocoder.xml:971 #, no-c-format msgid "" "SELECT topology.CreateTopology('topo_boston', 2249, 0.25);\n" @@ -1600,19 +1611,19 @@ msgid "" msgstr "" #. Tag: title -#: extras_tigergeocoder.xml:973 +#: extras_tigergeocoder.xml:975 #, no-c-format msgid "Example: Suffolk, Massachusetts Topology" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:974 +#: extras_tigergeocoder.xml:976 #, no-c-format msgid "Create a topology for Suffolk, Massachusetts in Mass State Plane Meters (26986) with tolerance 0.25 meters and then load in Suffolk county tiger faces, edges, nodes." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:976 +#: extras_tigergeocoder.xml:978 #, no-c-format msgid "" "SELECT topology.CreateTopology('topo_suffolk', 26986, 0.25);\n" @@ -1644,43 +1655,43 @@ msgid "" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:980 +#: extras_tigergeocoder.xml:982 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: extras_tigergeocoder.xml:986 +#: extras_tigergeocoder.xml:988 #, no-c-format msgid "Set_Geocode_Setting" msgstr "" #. Tag: refpurpose -#: extras_tigergeocoder.xml:988 +#: extras_tigergeocoder.xml:990 #, no-c-format msgid "Sets a setting that affects behavior of geocoder functions." msgstr "" #. Tag: funcprototype -#: extras_tigergeocoder.xml:993 +#: extras_tigergeocoder.xml:995 #, no-c-format msgid "text Set_Geocode_Setting text setting_name text setting_value" msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:1004 +#: extras_tigergeocoder.xml:1006 #, no-c-format msgid "Sets value of specific setting stored in tiger.geocode_settings table. Settings allow you to toggle debugging of functions. Later plans will be to control rating with settings. Current list of settings are listed in ." msgstr "" #. Tag: para -#: extras_tigergeocoder.xml:1013 +#: extras_tigergeocoder.xml:1015 #, no-c-format msgid "If you run when this function is true, the NOTICE log will output timing and queries." msgstr "" #. Tag: programlisting -#: extras_tigergeocoder.xml:1014 +#: extras_tigergeocoder.xml:1016 #, no-c-format msgid "" "SELECT set_geocode_setting('debug_geocode_address', 'true') As result;\n" diff --git a/doc/po/templates/extras_topology.xml.pot b/doc/po/templates/extras_topology.xml.pot index c4cef7109..8c8ab2a30 100644 --- a/doc/po/templates/extras_topology.xml.pot +++ b/doc/po/templates/extras_topology.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -35,7 +35,7 @@ msgstr "" #. Tag: para #: extras_topology.xml:6 #, no-c-format -msgid "Vincent Picavet provides a good synopsis and overview of what is Topology, how is it used, and various FOSS4G tools that support it in State of the art of FOSS4G for topology and network analysis." +msgid "Vincent Picavet provides a good synopsis and overview of what is Topology, how is it used, and various FOSS4G tools that support it in PostGIS Topology PGConf EU 2012." msgstr "" #. Tag: para @@ -99,7 +99,7 @@ msgid "A composite type that consists of a sequence number and edge number. This msgstr "" #. Tag: title -#: extras_topology.xml:31 extras_topology.xml:50 extras_topology.xml:99 extras_topology.xml:138 extras_topology.xml:163 extras_topology.xml:240 extras_topology.xml:287 extras_topology.xml:328 extras_topology.xml:367 extras_topology.xml:404 extras_topology.xml:474 extras_topology.xml:522 extras_topology.xml:570 extras_topology.xml:614 extras_topology.xml:662 extras_topology.xml:708 extras_topology.xml:754 extras_topology.xml:809 extras_topology.xml:855 extras_topology.xml:902 extras_topology.xml:959 extras_topology.xml:1017 extras_topology.xml:1089 extras_topology.xml:1157 extras_topology.xml:1223 extras_topology.xml:1278 extras_topology.xml:1326 extras_topology.xml:1373 extras_topology.xml:1416 extras_topology.xml:1470 extras_topology.xml:1564 extras_topology.xml:1659 extras_topology.xml:1701 extras_topology.xml:1743 extras_topology.xml:1786 extras_topology.xml:1836 extras_topology.xml:1880 extras_topology.xml:1932 extras_topology.xml:1990 extras_topology.xml:2031 extras_topology.xml:2088 extras_topology.xml:2134 extras_topology.xml:2206 extras_topology.xml:2260 extras_topology.xml:2331 extras_topology.xml:2407 extras_topology.xml:2452 extras_topology.xml:2484 extras_topology.xml:2522 extras_topology.xml:2570 extras_topology.xml:2665 extras_topology.xml:2719 extras_topology.xml:2782 extras_topology.xml:2831 +#: extras_topology.xml:31 extras_topology.xml:50 extras_topology.xml:99 extras_topology.xml:139 extras_topology.xml:184 extras_topology.xml:261 extras_topology.xml:308 extras_topology.xml:349 extras_topology.xml:388 extras_topology.xml:425 extras_topology.xml:553 extras_topology.xml:601 extras_topology.xml:649 extras_topology.xml:693 extras_topology.xml:741 extras_topology.xml:787 extras_topology.xml:833 extras_topology.xml:888 extras_topology.xml:934 extras_topology.xml:981 extras_topology.xml:1038 extras_topology.xml:1104 extras_topology.xml:1176 extras_topology.xml:1244 extras_topology.xml:1310 extras_topology.xml:1365 extras_topology.xml:1413 extras_topology.xml:1460 extras_topology.xml:1503 extras_topology.xml:1557 extras_topology.xml:1654 extras_topology.xml:1756 extras_topology.xml:1798 extras_topology.xml:1840 extras_topology.xml:1883 extras_topology.xml:1933 extras_topology.xml:1978 extras_topology.xml:2039 extras_topology.xml:2097 extras_topology.xml:2138 extras_topology.xml:2195 extras_topology.xml:2241 extras_topology.xml:2313 extras_topology.xml:2367 extras_topology.xml:2438 extras_topology.xml:2514 extras_topology.xml:2559 extras_topology.xml:2591 extras_topology.xml:2629 extras_topology.xml:2677 extras_topology.xml:2772 extras_topology.xml:2826 extras_topology.xml:2889 extras_topology.xml:2941 #, no-c-format msgid "Description" msgstr "" @@ -201,7 +201,7 @@ msgid "automatic" msgstr "" #. Tag: title -#: extras_topology.xml:88 extras_topology.xml:116 extras_topology.xml:149 extras_topology.xml:173 extras_topology.xml:265 extras_topology.xml:305 extras_topology.xml:345 extras_topology.xml:382 extras_topology.xml:423 extras_topology.xml:499 extras_topology.xml:548 extras_topology.xml:587 extras_topology.xml:636 extras_topology.xml:677 extras_topology.xml:723 extras_topology.xml:769 extras_topology.xml:830 extras_topology.xml:877 extras_topology.xml:933 extras_topology.xml:990 extras_topology.xml:1062 extras_topology.xml:1130 extras_topology.xml:1197 extras_topology.xml:1246 extras_topology.xml:1295 extras_topology.xml:1345 extras_topology.xml:1393 extras_topology.xml:1442 extras_topology.xml:1488 extras_topology.xml:1542 extras_topology.xml:1586 extras_topology.xml:1636 extras_topology.xml:1674 extras_topology.xml:1716 extras_topology.xml:1758 extras_topology.xml:1809 extras_topology.xml:1854 extras_topology.xml:1904 extras_topology.xml:1957 extras_topology.xml:2006 extras_topology.xml:2065 extras_topology.xml:2108 extras_topology.xml:2183 extras_topology.xml:2218 extras_topology.xml:2290 extras_topology.xml:2380 extras_topology.xml:2421 extras_topology.xml:2471 extras_topology.xml:2541 extras_topology.xml:2588 extras_topology.xml:2697 extras_topology.xml:2746 extras_topology.xml:2807 extras_topology.xml:2857 +#: extras_topology.xml:88 extras_topology.xml:117 extras_topology.xml:169 extras_topology.xml:194 extras_topology.xml:286 extras_topology.xml:326 extras_topology.xml:366 extras_topology.xml:403 extras_topology.xml:502 extras_topology.xml:578 extras_topology.xml:627 extras_topology.xml:666 extras_topology.xml:715 extras_topology.xml:756 extras_topology.xml:802 extras_topology.xml:848 extras_topology.xml:909 extras_topology.xml:956 extras_topology.xml:1012 extras_topology.xml:1077 extras_topology.xml:1149 extras_topology.xml:1217 extras_topology.xml:1284 extras_topology.xml:1333 extras_topology.xml:1382 extras_topology.xml:1432 extras_topology.xml:1480 extras_topology.xml:1529 extras_topology.xml:1575 extras_topology.xml:1628 extras_topology.xml:1675 extras_topology.xml:1729 extras_topology.xml:1771 extras_topology.xml:1813 extras_topology.xml:1855 extras_topology.xml:1906 extras_topology.xml:1951 extras_topology.xml:2011 extras_topology.xml:2064 extras_topology.xml:2113 extras_topology.xml:2172 extras_topology.xml:2215 extras_topology.xml:2290 extras_topology.xml:2325 extras_topology.xml:2397 extras_topology.xml:2487 extras_topology.xml:2528 extras_topology.xml:2578 extras_topology.xml:2648 extras_topology.xml:2695 extras_topology.xml:2804 extras_topology.xml:2853 extras_topology.xml:2914 extras_topology.xml:2970 #, no-c-format msgid "See Also" msgstr "" @@ -249,43 +249,55 @@ msgid "id2 is an integer: For errors that involve 2 objects d msgstr "" #. Tag: para -#: extras_topology.xml:125 +#: extras_topology.xml:126 #, no-c-format msgid "This section lists the PostgreSQL domains installed by PostGIS Topology. Domains can be used like object types as return objects of functions or table columns. The distinction between a domain and a type is that a domain is an existing type with a check constraint bound to it." msgstr "" #. Tag: title -#: extras_topology.xml:130 +#: extras_topology.xml:131 #, no-c-format msgid "Topology Domains" msgstr "" #. Tag: refname -#: extras_topology.xml:134 +#: extras_topology.xml:135 #, no-c-format msgid "TopoElement" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:135 +#: extras_topology.xml:136 #, no-c-format msgid "An array of 2 integers generally used to identify a TopoGeometry component." msgstr "" #. Tag: para -#: extras_topology.xml:139 +#: extras_topology.xml:140 +#, no-c-format +msgid "An array of 2 integers used to represent one component of a simple or hierarchical ." +msgstr "" + +#. Tag: para +#: extras_topology.xml:144 #, no-c-format -msgid "An array of 2 integers used to represent the id (first element) and type (second element) of a topology primitive or the id (first element) and layer (second element) of a TopoGeometry. Sets of such pairs are used to define TopoGeometry objects (either simple or hierarchical)." +msgid "In the case of a simple TopoGeometry the first element of the array represents the identifier of a topological primitive and the second element represents its type (1:node, 2:edge, 3:face). In the case of a hierarchical TopoGeometry the first element of the array represents the identifier of a child TopoGeometry and the second element represents its layer identifier." +msgstr "" + +#. Tag: para +#: extras_topology.xml:153 +#, no-c-format +msgid "For any given hierarchical TopoGeometry all child TopoGeometry elements will come from the same child layer, as specified in the topology.layer record for the layer of the TopoGeometry being defined." msgstr "" #. Tag: title -#: extras_topology.xml:142 extras_topology.xml:167 extras_topology.xml:258 extras_topology.xml:298 extras_topology.xml:339 extras_topology.xml:377 extras_topology.xml:417 extras_topology.xml:488 extras_topology.xml:538 extras_topology.xml:581 extras_topology.xml:630 extras_topology.xml:823 extras_topology.xml:870 extras_topology.xml:926 extras_topology.xml:983 extras_topology.xml:1055 extras_topology.xml:1123 extras_topology.xml:1191 extras_topology.xml:1240 extras_topology.xml:1387 extras_topology.xml:1436 extras_topology.xml:1482 extras_topology.xml:1534 extras_topology.xml:1579 extras_topology.xml:1628 extras_topology.xml:1668 extras_topology.xml:1710 extras_topology.xml:1752 extras_topology.xml:1802 extras_topology.xml:1848 extras_topology.xml:2059 extras_topology.xml:2102 extras_topology.xml:2177 extras_topology.xml:2371 extras_topology.xml:2417 extras_topology.xml:2465 extras_topology.xml:2534 extras_topology.xml:2581 extras_topology.xml:2688 extras_topology.xml:2751 extras_topology.xml:2800 extras_topology.xml:2850 +#: extras_topology.xml:162 extras_topology.xml:188 extras_topology.xml:279 extras_topology.xml:319 extras_topology.xml:360 extras_topology.xml:398 extras_topology.xml:496 extras_topology.xml:567 extras_topology.xml:617 extras_topology.xml:660 extras_topology.xml:709 extras_topology.xml:902 extras_topology.xml:949 extras_topology.xml:1005 extras_topology.xml:1070 extras_topology.xml:1142 extras_topology.xml:1210 extras_topology.xml:1278 extras_topology.xml:1327 extras_topology.xml:1474 extras_topology.xml:1523 extras_topology.xml:1569 extras_topology.xml:1620 extras_topology.xml:1668 extras_topology.xml:1721 extras_topology.xml:1765 extras_topology.xml:1807 extras_topology.xml:1849 extras_topology.xml:1899 extras_topology.xml:1945 extras_topology.xml:2166 extras_topology.xml:2209 extras_topology.xml:2284 extras_topology.xml:2478 extras_topology.xml:2524 extras_topology.xml:2572 extras_topology.xml:2641 extras_topology.xml:2688 extras_topology.xml:2795 extras_topology.xml:2858 extras_topology.xml:2907 extras_topology.xml:2963 #, no-c-format msgid "Examples" msgstr "" #. Tag: programlisting -#: extras_topology.xml:143 +#: extras_topology.xml:163 #, no-c-format msgid "" "SELECT te[1] AS id, te[2] AS type FROM\n" @@ -296,7 +308,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:144 +#: extras_topology.xml:164 #, no-c-format msgid "" "SELECT ARRAY[1,2]::topology.topoelement;\n" @@ -306,7 +318,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:145 +#: extras_topology.xml:165 #, no-c-format msgid "" "--Example of what happens when you try to case a 3 element array to topoelement\n" @@ -316,31 +328,31 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:150 extras_topology.xml:2422 extras_topology.xml:2542 +#: extras_topology.xml:170 #, no-c-format -msgid ", " +msgid ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:159 +#: extras_topology.xml:180 #, no-c-format msgid "TopoElementArray" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:160 +#: extras_topology.xml:181 #, no-c-format msgid "An array of TopoElement objects" msgstr "" #. Tag: para -#: extras_topology.xml:164 +#: extras_topology.xml:185 #, no-c-format msgid "An array of 1 or more TopoElement objects, generally used to pass around components of TopoGeometry objects." msgstr "" #. Tag: programlisting -#: extras_topology.xml:168 +#: extras_topology.xml:189 #, no-c-format msgid "" "SELECT '{{1,2},{4,3}}'::topology.topoelementarray As tea;\n" @@ -364,7 +376,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:169 +#: extras_topology.xml:190 #, no-c-format msgid "" "SELECT '{{1,2,4},{3,4,5}}'::topology.topoelementarray As tea;\n" @@ -372,79 +384,79 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:174 +#: extras_topology.xml:195 #, no-c-format msgid ", , " msgstr "" #. Tag: para -#: extras_topology.xml:186 +#: extras_topology.xml:207 #, no-c-format msgid "This section lists the Topology functions for building new Topology schemas, validating topologies, and managing TopoGeometry Columns" msgstr "" #. Tag: title -#: extras_topology.xml:189 +#: extras_topology.xml:210 #, no-c-format msgid "Topology and TopoGeometry Management" msgstr "" #. Tag: refname -#: extras_topology.xml:192 +#: extras_topology.xml:213 #, no-c-format msgid "AddTopoGeometryColumn" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:193 +#: extras_topology.xml:214 #, no-c-format msgid "Adds a topogeometry column to an existing table, registers this new column as a layer in topology.layer and returns the new layer_id." msgstr "" #. Tag: funcsynopsis -#: extras_topology.xml:197 +#: extras_topology.xml:218 #, no-c-format msgid " text AddTopoGeometryColumn varchar topology_name varchar schema_name varchar table_name varchar column_name varchar feature_type text AddTopoGeometryColumn varchar topology_name varchar schema_name varchar table_name varchar column_name varchar feature_type integer child_layer " msgstr "" #. Tag: para -#: extras_topology.xml:242 +#: extras_topology.xml:263 #, no-c-format msgid "Each TopoGeometry object belongs to a specific Layer of a specific Topology. Before creating a TopoGeometry object you need to create its TopologyLayer. A Topology Layer is an association of a feature-table with the topology. It also contain type and hierarchy information. We create a layer using the AddTopoGeometryColumn() function:" msgstr "" #. Tag: para -#: extras_topology.xml:244 +#: extras_topology.xml:265 #, no-c-format msgid "This function will both add the requested column to the table and add a record to the topology.layer table with all the given info." msgstr "" #. Tag: para -#: extras_topology.xml:245 +#: extras_topology.xml:266 #, no-c-format msgid "If you don't specify [child_layer] (or set it to NULL) this layer would contain Basic TopoGeometries (composed by primitive topology elements). Otherwise this layer will contain hierarchical TopoGeometries (composed by TopoGeometries from the child_layer)." msgstr "" #. Tag: para -#: extras_topology.xml:248 +#: extras_topology.xml:269 #, no-c-format -msgid "Once the layer is created (it's id is returned by the AddTopoGeometryColumn function) you're ready to construct TopoGeometry objects in it" +msgid "Once the layer is created (its id is returned by the AddTopoGeometryColumn function) you're ready to construct TopoGeometry objects in it" msgstr "" #. Tag: para -#: extras_topology.xml:249 +#: extras_topology.xml:270 #, no-c-format msgid "Valid feature_types are: POINT, LINE, POLYGON, COLLECTION" msgstr "" #. Tag: para -#: extras_topology.xml:252 extras_topology.xml:293 extras_topology.xml:334 extras_topology.xml:410 extras_topology.xml:483 extras_topology.xml:575 extras_topology.xml:817 extras_topology.xml:864 extras_topology.xml:1233 extras_topology.xml:1381 extras_topology.xml:1430 extras_topology.xml:1476 extras_topology.xml:1663 extras_topology.xml:1747 extras_topology.xml:1842 extras_topology.xml:2268 extras_topology.xml:2529 extras_topology.xml:2576 extras_topology.xml:2791 extras_topology.xml:2841 +#: extras_topology.xml:273 extras_topology.xml:314 extras_topology.xml:355 extras_topology.xml:562 extras_topology.xml:654 extras_topology.xml:896 extras_topology.xml:943 extras_topology.xml:1320 extras_topology.xml:1468 extras_topology.xml:1517 extras_topology.xml:1563 extras_topology.xml:1760 extras_topology.xml:1844 extras_topology.xml:1939 extras_topology.xml:2375 extras_topology.xml:2636 extras_topology.xml:2683 #, no-c-format msgid "Availability: 1.?" msgstr "" #. Tag: programlisting -#: extras_topology.xml:259 +#: extras_topology.xml:280 #, no-c-format msgid "" "-- Note for this example we created our new table in the ma_topo schema \n" @@ -455,7 +467,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:260 +#: extras_topology.xml:281 #, no-c-format msgid "" "CREATE SCHEMA ri;\n" @@ -464,109 +476,109 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:267 +#: extras_topology.xml:288 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_topology.xml:272 +#: extras_topology.xml:293 #, no-c-format msgid "DropTopology" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:274 +#: extras_topology.xml:295 #, no-c-format msgid "Use with caution: Drops a topology schema and deletes its reference from topology.topology table and references to tables in that schema from the geometry_columns table." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:279 +#: extras_topology.xml:300 #, no-c-format msgid "integer DropTopology varchar topology_schema_name" msgstr "" #. Tag: para -#: extras_topology.xml:289 +#: extras_topology.xml:310 #, no-c-format msgid "Drops a topology schema and deletes its reference from topology.topology table and references to tables in that schema from the geometry_columns table. This function should be USED WITH CAUTION, as it could destroy data you care about. If the schema does not exist, it just removes reference entries the named schema." msgstr "" #. Tag: para -#: extras_topology.xml:299 +#: extras_topology.xml:320 #, no-c-format msgid "Cascade drops the ma_topo schema and removes all references to it in topology.topology and geometry_columns." msgstr "" #. Tag: programlisting -#: extras_topology.xml:300 +#: extras_topology.xml:321 #, no-c-format msgid "SELECT topology.DropTopology('ma_topo');" msgstr "" #. Tag: refname -#: extras_topology.xml:311 +#: extras_topology.xml:332 #, no-c-format msgid "DropTopoGeometryColumn" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:313 +#: extras_topology.xml:334 #, no-c-format msgid "Drops the topogeometry column from the table named table_name in schema schema_name and unregisters the columns from topology.layer table." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:318 +#: extras_topology.xml:339 #, no-c-format msgid "text DropTopoGeometryColumn varchar schema_name varchar table_name varchar column_name" msgstr "" #. Tag: para -#: extras_topology.xml:330 +#: extras_topology.xml:351 #, no-c-format msgid "Drops the topogeometry column from the table named table_name in schema schema_name and unregisters the columns from topology.layer table. Returns summary of drop status. NOTE: it first sets all values to NULL before dropping to bypass referential integrity checks." msgstr "" #. Tag: programlisting -#: extras_topology.xml:340 +#: extras_topology.xml:361 #, no-c-format msgid "SELECT topology.DropTopoGeometryColumn('ma_topo', 'parcel_topo', 'topo');" msgstr "" #. Tag: refname -#: extras_topology.xml:352 +#: extras_topology.xml:373 #, no-c-format msgid "TopologySummary" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:354 +#: extras_topology.xml:375 #, no-c-format msgid "Takes a topology name and provides summary totals of types of objects in topology" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:359 +#: extras_topology.xml:380 #, no-c-format msgid "text TopologySummary varchar topology_schema_name" msgstr "" #. Tag: para -#: extras_topology.xml:369 +#: extras_topology.xml:390 #, no-c-format msgid "Takes a topology name and provides summary totals of types of objects in topology." msgstr "" #. Tag: para -#: extras_topology.xml:372 extras_topology.xml:533 extras_topology.xml:671 extras_topology.xml:717 extras_topology.xml:763 extras_topology.xml:1705 extras_topology.xml:2001 extras_topology.xml:2054 extras_topology.xml:2172 extras_topology.xml:2412 extras_topology.xml:2683 +#: extras_topology.xml:393 extras_topology.xml:612 extras_topology.xml:750 extras_topology.xml:796 extras_topology.xml:842 extras_topology.xml:1802 extras_topology.xml:2005 extras_topology.xml:2108 extras_topology.xml:2161 extras_topology.xml:2279 extras_topology.xml:2519 extras_topology.xml:2790 #, no-c-format msgid "Availability: 2.0.0" msgstr "" #. Tag: programlisting -#: extras_topology.xml:378 +#: extras_topology.xml:399 #, no-c-format msgid "" "SELECT topology.topologysummary('city_data');\n" @@ -589,37 +601,163 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:389 +#: extras_topology.xml:410 #, no-c-format msgid "ValidateTopology" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:391 +#: extras_topology.xml:412 #, no-c-format msgid "Returns a set of validatetopology_returntype objects detailing issues with topology" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:396 +#: extras_topology.xml:417 #, no-c-format msgid "setof validatetopology_returntype ValidateTopology varchar topology_schema_name" msgstr "" #. Tag: para -#: extras_topology.xml:406 +#: extras_topology.xml:427 +#, no-c-format +msgid "Returns a set of objects detailing issues with topology. List of possible errors and what the returned ids represent are displayed below:" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:431 +#, no-c-format +msgid "Error" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:431 +#, no-c-format +msgid "id1" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:431 +#, no-c-format +msgid "id2" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:434 +#, no-c-format +msgid "edge crosses node" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:435 extras_topology.xml:440 extras_topology.xml:445 extras_topology.xml:450 extras_topology.xml:451 extras_topology.xml:455 extras_topology.xml:460 +#, no-c-format +msgid "edge_id" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:436 extras_topology.xml:456 extras_topology.xml:461 +#, no-c-format +msgid "node_id" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:439 +#, no-c-format +msgid "invalid edge" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:441 extras_topology.xml:446 extras_topology.xml:466 extras_topology.xml:471 +#, no-c-format +msgid "null" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:444 +#, no-c-format +msgid "edge not simple" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:449 +#, no-c-format +msgid "edge crosses edge" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:454 +#, no-c-format +msgid "edge start node geometry mis-match" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:459 +#, no-c-format +msgid "edge end node geometry mis-match" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:464 +#, no-c-format +msgid "face without edges" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:465 extras_topology.xml:470 extras_topology.xml:475 extras_topology.xml:476 +#, no-c-format +msgid "face_id" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:469 +#, no-c-format +msgid "face has no rings" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:474 +#, no-c-format +msgid "face overlaps face" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:479 +#, no-c-format +msgid "face within face" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:480 +#, no-c-format +msgid "inner face_id" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:481 +#, no-c-format +msgid "outer face_id" +msgstr "" + +#. Tag: para +#: extras_topology.xml:488 #, no-c-format -msgid "Returns a set of objects detailing issues with topology. Refer to for listing of possible errors." +msgid "Availability: 1.0.0" msgstr "" #. Tag: para -#: extras_topology.xml:412 +#: extras_topology.xml:490 #, no-c-format msgid "Enhanced: 2.0.0 more efficient edge crossing detection and fixes for false positives that were existent in prior versions." msgstr "" +#. Tag: para +#: extras_topology.xml:491 +#, no-c-format +msgid "Changed: 2.2.0 values for id1 and id2 were swapped for 'edge crosses node' to be consistent with error description." +msgstr "" + #. Tag: programlisting -#: extras_topology.xml:418 +#: extras_topology.xml:497 #, no-c-format msgid "" "SELECT * FROM topology.ValidateTopology('ma_topo');\n" @@ -629,73 +767,73 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:424 +#: extras_topology.xml:503 #, no-c-format msgid ", " msgstr "" #. Tag: para -#: extras_topology.xml:432 +#: extras_topology.xml:511 #, no-c-format msgid "This section covers the topology functions for creating new topologies." msgstr "" #. Tag: title -#: extras_topology.xml:435 +#: extras_topology.xml:514 #, no-c-format msgid "Topology Constructors" msgstr "" #. Tag: refname -#: extras_topology.xml:439 +#: extras_topology.xml:518 #, no-c-format msgid "CreateTopology" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:440 +#: extras_topology.xml:519 #, no-c-format msgid "Creates a new topology schema and registers this new schema in the topology.topology table." msgstr "" #. Tag: funcsynopsis -#: extras_topology.xml:444 +#: extras_topology.xml:523 #, no-c-format msgid " integer CreateTopology varchar topology_schema_name integer CreateTopology varchar topology_schema_name integer srid integer CreateTopology varchar topology_schema_name integer srid double precision tolerance integer CreateTopology varchar topology_schema_name integer srid double precision tolerance boolean hasz " msgstr "" #. Tag: para -#: extras_topology.xml:476 +#: extras_topology.xml:555 #, no-c-format msgid "Creates a new schema with name topology_name consisting of tables (edge_data,face,node, relation and registers this new topology in the topology.topology table. It returns the id of the topology in the topology table. The srid is the spatial reference identified as defined in spatial_ref_sys table for that topology. Topologies must be uniquely named. The tolerance is measured in the units of the spatial reference system. If the tolerance is not specified defaults to 0." msgstr "" #. Tag: para -#: extras_topology.xml:480 +#: extras_topology.xml:559 #, no-c-format msgid "This is similar to the SQL/MM but a bit more functional. hasz defaults to false if not specified." msgstr "" #. Tag: para -#: extras_topology.xml:489 +#: extras_topology.xml:568 #, no-c-format msgid "This example creates a new schema called ma_topo that will store edges, faces, and relations in Massachusetts State Plane meters. The tolerance represents 1/2 meter since the spatial reference system is a meter based spatial reference system" msgstr "" #. Tag: programlisting -#: extras_topology.xml:491 +#: extras_topology.xml:570 #, no-c-format msgid "SELECT topology.CreateTopology('ma_topo',26986, 0.5);" msgstr "" #. Tag: para -#: extras_topology.xml:493 +#: extras_topology.xml:572 #, no-c-format msgid "Create Rhode Island topology in State Plane ft" msgstr "" #. Tag: programlisting -#: extras_topology.xml:494 +#: extras_topology.xml:573 #, no-c-format msgid "" "SELECT topology.CreateTopology('ri_topo',3438) As topoid;\n" @@ -705,91 +843,91 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:501 +#: extras_topology.xml:580 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:507 +#: extras_topology.xml:586 #, no-c-format msgid "CopyTopology" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:508 +#: extras_topology.xml:587 #, no-c-format msgid "Makes a copy of a topology structure (nodes, edges, faces, layers and TopoGeometries)." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:513 +#: extras_topology.xml:592 #, no-c-format msgid "integer CopyTopology varchar existing_topology_name varchar new_name" msgstr "" #. Tag: para -#: extras_topology.xml:524 +#: extras_topology.xml:603 #, no-c-format msgid "Creates a new topology with name new_topology_name and SRID and precision taken from existing_topology_name, copies all nodes, edges and faces in there, copies layers and their TopoGeometries too." msgstr "" #. Tag: para -#: extras_topology.xml:528 +#: extras_topology.xml:607 #, no-c-format msgid "The new rows in topology.layer will contain synthesized values for schema_name, table_name and feature_column. This is because the TopoGeometry will only exist as a definition but won't be available in any user-level table yet." msgstr "" #. Tag: para -#: extras_topology.xml:539 +#: extras_topology.xml:618 #, no-c-format msgid "This example makes a backup of a topology called ma_topo" msgstr "" #. Tag: programlisting -#: extras_topology.xml:542 +#: extras_topology.xml:621 #, no-c-format msgid "SELECT topology.CopyTopology('ma_topo', 'ma_topo_bakup');" msgstr "" #. Tag: para -#: extras_topology.xml:550 extras_topology.xml:2066 +#: extras_topology.xml:629 extras_topology.xml:2173 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_topology.xml:556 +#: extras_topology.xml:635 #, no-c-format msgid "ST_InitTopoGeo" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:557 +#: extras_topology.xml:636 #, no-c-format msgid "Creates a new topology schema and registers this new schema in the topology.topology table and details summary of process." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:562 +#: extras_topology.xml:641 #, no-c-format msgid "text ST_InitTopoGeo varchar topology_schema_name" msgstr "" #. Tag: para -#: extras_topology.xml:572 +#: extras_topology.xml:651 #, no-c-format msgid "This is an SQL-MM equivalent of CreateTopology but lacks the spatial reference and tolerance options of CreateTopology and outputs a text description of creation instead of topology id." msgstr "" #. Tag: para -#: extras_topology.xml:576 +#: extras_topology.xml:655 #, 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:582 +#: extras_topology.xml:661 #, no-c-format msgid "" "SELECT topology.ST_InitTopoGeo('topo_schema_to_create') AS topocreation;\n" @@ -799,49 +937,49 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:596 +#: extras_topology.xml:675 #, no-c-format msgid "ST_CreateTopoGeo" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:598 +#: extras_topology.xml:677 #, no-c-format msgid "Adds a collection of geometries to a given empty topology and returns a message detailing success." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:605 +#: extras_topology.xml:684 #, no-c-format msgid "text ST_CreateTopoGeo varchar atopology geometry acollection" msgstr "" #. Tag: para -#: extras_topology.xml:616 +#: extras_topology.xml:695 #, no-c-format msgid "Adds a collection of geometries to a given empty topology and returns a message detailing success." msgstr "" #. Tag: para -#: extras_topology.xml:620 +#: extras_topology.xml:699 #, no-c-format msgid "Useful for populating an empty topology." msgstr "" #. Tag: para -#: extras_topology.xml:624 extras_topology.xml:920 extras_topology.xml:977 extras_topology.xml:1049 extras_topology.xml:1117 extras_topology.xml:1288 extras_topology.xml:1338 extras_topology.xml:1796 extras_topology.xml:1898 extras_topology.xml:1952 extras_topology.xml:2367 +#: extras_topology.xml:703 extras_topology.xml:999 extras_topology.xml:1064 extras_topology.xml:1136 extras_topology.xml:1204 extras_topology.xml:1375 extras_topology.xml:1425 extras_topology.xml:1893 extras_topology.xml:2059 extras_topology.xml:2474 #, no-c-format msgid "Availability: 2.0" msgstr "" #. Tag: para -#: extras_topology.xml:625 +#: extras_topology.xml:704 #, 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:631 +#: extras_topology.xml:710 #, no-c-format msgid "" "-- Populate topology --\n" @@ -870,433 +1008,445 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:637 +#: extras_topology.xml:716 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:643 +#: extras_topology.xml:722 #, no-c-format msgid "TopoGeo_AddPoint" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:645 +#: extras_topology.xml:724 #, no-c-format msgid "Adds a point to an existing topology using a tolerance and possibly splitting an existing edge." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:652 +#: extras_topology.xml:731 #, no-c-format msgid "integer TopoGeo_AddPoint varchar toponame geometry apoint float8 tolerance" msgstr "" #. Tag: para -#: extras_topology.xml:664 +#: extras_topology.xml:743 #, no-c-format msgid "Adds a point to an existing topology and return its identifier. The given point will snap to existing nodes or edges within given tolerance. An existing edge may be split by the snapped point." msgstr "" #. Tag: para -#: extras_topology.xml:678 +#: extras_topology.xml:757 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: extras_topology.xml:689 +#: extras_topology.xml:768 #, no-c-format msgid "TopoGeo_AddLineString" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:691 +#: extras_topology.xml:770 #, no-c-format msgid "Adds a linestring to an existing topology using a tolerance and possibly splitting existing edges/faces. Returns edge identifiers" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:698 +#: extras_topology.xml:777 #, no-c-format msgid "SETOF integer TopoGeo_AddLineString varchar toponame geometry aline float8 tolerance" msgstr "" #. Tag: para -#: extras_topology.xml:710 +#: extras_topology.xml:789 #, no-c-format msgid "Adds a linestring to an existing topology and return a set of edge identifiers forming it up. The given line will snap to existing nodes or edges within given tolerance. Existing edges and faces may be split by the line." msgstr "" #. Tag: para -#: extras_topology.xml:724 +#: extras_topology.xml:803 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: extras_topology.xml:735 +#: extras_topology.xml:814 #, no-c-format msgid "TopoGeo_AddPolygon" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:737 +#: extras_topology.xml:816 #, no-c-format msgid "Adds a polygon to an existing topology using a tolerance and possibly splitting existing edges/faces." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:744 +#: extras_topology.xml:823 #, no-c-format msgid "integer TopoGeo_AddPolygon varchar atopology geometry apoly float8 atolerance" msgstr "" #. Tag: para -#: extras_topology.xml:756 +#: extras_topology.xml:835 #, no-c-format msgid "Adds a polygon to an existing topology and return a set of face identifiers forming it up. The boundary of the given polygon will snap to existing nodes or edges within given tolerance. Existing edges and faces may be split by the boundary of the new polygon." msgstr "" #. Tag: para -#: extras_topology.xml:770 +#: extras_topology.xml:849 #, no-c-format msgid ", , , " msgstr "" #. Tag: para -#: extras_topology.xml:785 +#: extras_topology.xml:864 #, no-c-format msgid "This section covers topology functions for adding, moving, deleting, and splitting edges, faces, and nodes. All of these functions are defined by ISO SQL/MM." msgstr "" #. Tag: title -#: extras_topology.xml:788 +#: extras_topology.xml:867 #, no-c-format msgid "Topology Editors" msgstr "" #. Tag: refname -#: extras_topology.xml:792 +#: extras_topology.xml:871 #, no-c-format msgid "ST_AddIsoNode" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:794 +#: extras_topology.xml:873 #, no-c-format msgid "Adds an isolated node to a face in a topology and returns the nodeid of the new node. If face is null, the node is still created." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:799 +#: extras_topology.xml:878 #, no-c-format msgid "integer ST_AddIsoNode varchar atopology integer aface geometry apoint" msgstr "" #. Tag: para -#: extras_topology.xml:811 +#: extras_topology.xml:890 #, no-c-format msgid "Adds an isolated node with point location apoint to an existing face with faceid aface to a topology atopology and returns the nodeid of the new node." msgstr "" #. Tag: para -#: extras_topology.xml:812 +#: extras_topology.xml:891 #, no-c-format msgid "If the spatial reference system (srid) of the point geometry is not the same as the topology, the apoint is not a point geometry, the point is null, or the point intersects an existing edge (even at the boundaries) then an exception is thrown. If the point already exists as a node, an exception is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:814 +#: extras_topology.xml:893 #, no-c-format msgid "If aface is not null and the apoint is not within the face, then an exception is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:818 +#: extras_topology.xml:897 #, no-c-format msgid "&sqlmm_compliant; SQL-MM: Topo-Net Routines: X+1.3.1" msgstr "" #. Tag: para -#: extras_topology.xml:831 +#: extras_topology.xml:910 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: extras_topology.xml:837 +#: extras_topology.xml:916 #, no-c-format msgid "ST_AddIsoEdge" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:839 +#: extras_topology.xml:918 #, no-c-format msgid "Adds an isolated edge defined by geometry alinestring to a topology connecting two existing isolated nodes anode and anothernode and returns the edge id of the new edge." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:844 +#: extras_topology.xml:923 #, no-c-format msgid "integer ST_AddIsoEdge varchar atopology integer anode integer anothernode geometry alinestring" msgstr "" #. Tag: para -#: extras_topology.xml:857 +#: extras_topology.xml:936 #, no-c-format msgid "Adds an isolated edge defined by geometry alinestring to a topology connecting two existing isolated nodes anode and anothernode and returns the edge id of the new edge." msgstr "" #. Tag: para -#: extras_topology.xml:858 +#: extras_topology.xml:937 #, no-c-format msgid "If the spatial reference system (srid) of the alinestring geometry is not the same as the topology, any of the input arguments are null, or the nodes are contained in more than one face, or the nodes are start or end nodes of an existing edge, then an exception is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:860 +#: extras_topology.xml:939 #, no-c-format msgid "If the alinestring is not within the face of the face the anode and anothernode belong to, then an exception is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:861 +#: extras_topology.xml:940 #, no-c-format msgid "If the anode and anothernode are not the start and end points of the alinestring then an exception is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:865 +#: extras_topology.xml:944 #, 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:878 +#: extras_topology.xml:957 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:884 +#: extras_topology.xml:963 #, no-c-format msgid "ST_AddEdgeNewFaces" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:886 +#: extras_topology.xml:965 #, no-c-format msgid "Add a new edge and, if in doing so it splits a face, delete the original face and replace it with two new faces." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:891 +#: extras_topology.xml:970 #, no-c-format msgid "integer ST_AddEdgeNewFaces varchar atopology integer anode integer anothernode geometry acurve" msgstr "" #. Tag: para -#: extras_topology.xml:904 +#: extras_topology.xml:983 #, no-c-format msgid "Add a new edge and, if in doing so it splits a face, delete the original face and replace it with two new faces. Returns the id of the newly added edge." msgstr "" #. Tag: para -#: extras_topology.xml:910 extras_topology.xml:968 extras_topology.xml:1031 extras_topology.xml:1099 +#: extras_topology.xml:989 extras_topology.xml:1055 extras_topology.xml:1118 extras_topology.xml:1186 #, no-c-format msgid "Updates all existing joined edges and relationships accordingly." msgstr "" #. Tag: para -#: extras_topology.xml:914 extras_topology.xml:972 +#: extras_topology.xml:993 extras_topology.xml:1059 #, no-c-format msgid "If any arguments are null, the given nodes are unknown (must already exist in the node table of the topology schema) , the acurve is not a LINESTRING, the anode and anothernode are not the start and endpoints of acurve then an error is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:917 extras_topology.xml:975 extras_topology.xml:1170 +#: extras_topology.xml:996 extras_topology.xml:1062 extras_topology.xml:1257 #, no-c-format msgid "If the spatial reference system (srid) of the acurve geometry is not the same as the topology an exception is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:921 +#: extras_topology.xml:1000 #, 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:941 +#: extras_topology.xml:1020 #, no-c-format msgid "ST_AddEdgeModFace" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:943 +#: extras_topology.xml:1022 #, no-c-format msgid "Add a new edge and, if in doing so it splits a face, modify the original face and add a new face." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:948 +#: extras_topology.xml:1027 #, no-c-format msgid "integer ST_AddEdgeModFace varchar atopology integer anode integer anothernode geometry acurve" msgstr "" #. Tag: para -#: extras_topology.xml:961 +#: extras_topology.xml:1040 #, no-c-format -msgid "Add a new edge and, if in doing so it splits a face, modify the original face and add a new face. Unless the face being split is the Universal Face, the new face will be on the right side of the newly added edge. Returns the id of the newly added edge." +msgid "Add a new edge and, if doing so splits a face, modify the original face and add a new one." msgstr "" #. Tag: para -#: extras_topology.xml:978 +#: extras_topology.xml:1045 +#, no-c-format +msgid "If possible, the new face will be created on left side of the new edge. This will not be possible if the face on the left side will need to be the Universe face (unbounded)." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1051 +#, no-c-format +msgid "Returns the id of the newly added edge." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1065 #, 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:998 +#: extras_topology.xml:1085 #, no-c-format msgid "ST_RemEdgeNewFace" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1000 +#: extras_topology.xml:1087 #, no-c-format msgid "Removes an edge and, if the removed edge separated two faces, delete the original faces and replace them with a new face." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1008 +#: extras_topology.xml:1095 #, no-c-format msgid "integer ST_RemEdgeNewFace varchar atopology integer anedge" msgstr "" #. Tag: para -#: extras_topology.xml:1019 +#: extras_topology.xml:1106 #, no-c-format msgid "Removes an edge and, if the removed edge separated two faces, delete the original faces and replace them with a new face." msgstr "" #. Tag: para -#: extras_topology.xml:1024 +#: extras_topology.xml:1111 #, no-c-format msgid "Returns the id of a newly created face or NULL, if no new face is created. No new face is created when the removed edge is dangling or isolated or confined with the universe face (possibly making the universe flood into the face on the other side)." msgstr "" #. Tag: para -#: extras_topology.xml:1035 extras_topology.xml:1103 +#: extras_topology.xml:1122 extras_topology.xml:1190 #, no-c-format msgid "Refuses to remove an edge partecipating in the definition of an existing TopoGeometry. Refuses to heal two faces if any TopoGeometry is defined by only one of them (and not the other)." msgstr "" #. Tag: para -#: extras_topology.xml:1042 extras_topology.xml:1110 +#: extras_topology.xml:1129 extras_topology.xml:1197 #, no-c-format msgid "If any arguments are null, the given edge is unknown (must already exist in the edge table of the topology schema), the topology name is invalid then an error is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:1050 +#: extras_topology.xml:1137 #, 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:1070 +#: extras_topology.xml:1157 #, no-c-format msgid "ST_RemEdgeModFace" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1072 +#: extras_topology.xml:1159 #, no-c-format msgid "Removes an edge and, if the removed edge separated two faces, delete one of the them and modify the other to take the space of both." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1080 +#: extras_topology.xml:1167 #, no-c-format msgid "integer ST_RemEdgeModFace varchar atopology integer anedge" msgstr "" #. Tag: para -#: extras_topology.xml:1091 +#: extras_topology.xml:1178 #, no-c-format msgid "Removes an edge and, if the removed edge separated two faces, delete one of the them and modify the other to take the space of both. Preferentially keeps the face on the right, to be symmetric with ST_AddEdgeModFace also keeping it. Returns the id of the face remaining in place of the removed edge." msgstr "" #. Tag: para -#: extras_topology.xml:1118 +#: extras_topology.xml:1205 #, 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:1138 +#: extras_topology.xml:1225 #, no-c-format msgid "ST_ChangeEdgeGeom" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1140 +#: extras_topology.xml:1227 #, no-c-format msgid "Changes the shape of an edge without affecting the topology structure." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1147 +#: extras_topology.xml:1234 #, no-c-format msgid "integer ST_ChangeEdgeGeom varchar atopology integer anedge geometry acurve" msgstr "" #. Tag: para -#: extras_topology.xml:1159 +#: extras_topology.xml:1246 #, no-c-format msgid "Changes the shape of an edge without affecting the topology structure." msgstr "" #. Tag: para -#: extras_topology.xml:1162 +#: extras_topology.xml:1249 #, no-c-format msgid "If any arguments are null, the given edge does not exist in the node table of the topology schema, the acurve is not a LINESTRING, the anode and anothernode are not the start and endpoints of acurve or the modification would change the underlying topology then an error is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:1171 +#: extras_topology.xml:1258 #, no-c-format msgid "If the new acurve is not simple, then an error is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:1173 +#: extras_topology.xml:1260 #, no-c-format msgid "If moving the edge from old to new position would hit an obstacle then an error is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:1179 +#: extras_topology.xml:1266 extras_topology.xml:2898 extras_topology.xml:2954 #, no-c-format msgid "Availability: 1.1.0" msgstr "" #. Tag: para -#: extras_topology.xml:1182 +#: extras_topology.xml:1269 #, no-c-format msgid "Enhanced: 2.0.0 adds topological consistency enforcement" msgstr "" #. Tag: para -#: extras_topology.xml:1186 +#: extras_topology.xml:1273 #, 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:1192 +#: extras_topology.xml:1279 #, no-c-format msgid "" "SELECT topology.ST_ChangeEdgeGeom('ma_topo', 1, \n" @@ -1306,43 +1456,43 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:1206 +#: extras_topology.xml:1293 #, no-c-format msgid "ST_ModEdgeSplit" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1208 +#: extras_topology.xml:1295 #, no-c-format msgid "Split an edge by creating a new node along an existing edge, modifying the original edge and adding a new edge." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1213 +#: extras_topology.xml:1300 #, no-c-format msgid "integer ST_ModEdgeSplit varchar atopology integer anedge geometry apoint" msgstr "" #. Tag: para -#: extras_topology.xml:1225 +#: extras_topology.xml:1312 #, no-c-format msgid "Split an edge by creating a new node along an existing edge, modifying the original edge and adding a new edge. Updates all existing joined edges and relationships accordingly. Returns the identifier of the newly added node." msgstr "" #. Tag: para -#: extras_topology.xml:1234 +#: extras_topology.xml:1321 #, no-c-format msgid "Changed: 2.0 - In prior versions, this was misnamed ST_ModEdgesSplit" msgstr "" #. Tag: para -#: extras_topology.xml:1235 extras_topology.xml:1289 extras_topology.xml:1339 +#: extras_topology.xml:1322 extras_topology.xml:1376 extras_topology.xml:1426 #, 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:1241 +#: extras_topology.xml:1328 #, no-c-format msgid "" "-- Add an edge --\n" @@ -1360,103 +1510,103 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1247 +#: extras_topology.xml:1334 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: extras_topology.xml:1258 +#: extras_topology.xml:1345 #, no-c-format msgid "ST_ModEdgeHeal" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1260 +#: extras_topology.xml:1347 #, no-c-format msgid "Heal two edges by deleting the node connecting them, modifying the first edge and deleting the second edge. Returns the id of the deleted node." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1268 +#: extras_topology.xml:1355 #, no-c-format msgid "int ST_ModEdgeHeal varchar atopology integer anedge integer anotheredge" msgstr "" #. Tag: para -#: extras_topology.xml:1280 +#: extras_topology.xml:1367 #, no-c-format msgid "Heal two edges by deleting the node connecting them, modifying the first edge and deleting the second edge. Returns the id of the deleted node. Updates all existing joined edges and relationships accordingly." msgstr "" #. Tag: refname -#: extras_topology.xml:1305 +#: extras_topology.xml:1392 #, no-c-format msgid "ST_NewEdgeHeal" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1307 +#: extras_topology.xml:1394 #, no-c-format msgid "Heal two edges by deleting the node connecting them, deleting both edges, and replacing them with an edge whose direction is the same as the first edge provided." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1316 +#: extras_topology.xml:1403 #, no-c-format msgid "int ST_NewEdgeHeal varchar atopology integer anedge integer anotheredge" msgstr "" #. Tag: para -#: extras_topology.xml:1328 +#: extras_topology.xml:1415 #, no-c-format msgid "Heal two edges by deleting the node connecting them, deleting both edges, and replacing them with an edge whose direction is the same as the first edge provided. Returns the id of the new edge replacing the healed ones. Updates all existing joined edges and relationships accordingly." msgstr "" #. Tag: refname -#: extras_topology.xml:1356 +#: extras_topology.xml:1443 #, no-c-format msgid "ST_MoveIsoNode" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1358 +#: extras_topology.xml:1445 #, no-c-format msgid "Moves an isolated node in a topology from one point to another. If new apoint geometry exists as a node an error is thrown. REturns description of move." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1363 +#: extras_topology.xml:1450 #, no-c-format msgid "text ST_MoveIsoNode varchar atopology integer anedge geometry apoint" msgstr "" #. Tag: para -#: extras_topology.xml:1375 +#: extras_topology.xml:1462 #, no-c-format msgid "Moves an isolated node in a topology from one point to another. If new apoint geometry exists as a node an error is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:1376 +#: extras_topology.xml:1463 #, no-c-format msgid "If any arguments are null, the apoint is not a point, the existing node is not isolated (is a start or end point of an existing edge), new node location intersects an existing edge (even at the end points) then an exception is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:1377 +#: extras_topology.xml:1464 #, no-c-format msgid "If the spatial reference system (srid) of the point geometry is not the same as the topology an exception is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:1382 +#: extras_topology.xml:1469 #, no-c-format msgid "&sqlmm_compliant; SQL-MM: Topo-Net Routines: X.3.2" msgstr "" #. Tag: programlisting -#: extras_topology.xml:1388 +#: extras_topology.xml:1475 #, no-c-format msgid "" "-- Add an isolated node with no face --\n" @@ -1472,43 +1622,43 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:1399 +#: extras_topology.xml:1486 #, no-c-format msgid "ST_NewEdgesSplit" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1401 +#: extras_topology.xml:1488 #, no-c-format msgid "Split an edge by creating a new node along an existing edge, deleting the original edge and replacing it with two new edges. Returns the id of the new node created that joins the new edges." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1406 +#: extras_topology.xml:1493 #, no-c-format msgid "integer ST_NewEdgesSplit varchar atopology integer anedge geometry apoint" msgstr "" #. Tag: para -#: extras_topology.xml:1418 +#: extras_topology.xml:1505 #, no-c-format msgid "Split an edge with edge id anedge by creating a new node with point location apoint along current edge, deleting the original edge and replacing it with two new edges. Returns the id of the new node created that joins the new edges. Updates all existing joined edges and relationships accordingly." msgstr "" #. Tag: para -#: extras_topology.xml:1426 +#: extras_topology.xml:1513 #, no-c-format msgid "If the spatial reference system (srid) of the point geometry is not the same as the topology, the apoint is not a point geometry, the point is null, the point already exists as a node, the edge does not correspond to an existing edge or the point is not within the edge then an exception is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:1431 +#: extras_topology.xml:1518 #, no-c-format msgid "&sqlmm_compliant; SQL-MM: Topo-Net Routines: X.3.8" msgstr "" #. Tag: programlisting -#: extras_topology.xml:1437 +#: extras_topology.xml:1524 #, no-c-format msgid "" "-- Add an edge --\n" @@ -1525,37 +1675,37 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:1454 +#: extras_topology.xml:1541 #, no-c-format msgid "ST_RemoveIsoNode" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1456 +#: extras_topology.xml:1543 #, no-c-format msgid "Removes an isolated node and returns description of action. If the node is not isolated (is start or end of an edge), then an exception is thrown." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1461 +#: extras_topology.xml:1548 #, no-c-format msgid "text ST_RemoveIsoNode varchar atopology integer anode" msgstr "" #. Tag: para -#: extras_topology.xml:1472 +#: extras_topology.xml:1559 #, no-c-format msgid "Removes an isolated node and returns description of action. If the node is not isolated (is start or end of an edge), then an exception is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:1477 +#: extras_topology.xml:1564 #, 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:1483 +#: extras_topology.xml:1570 #, no-c-format msgid "" "-- Add an isolated node with no face --\n" @@ -1566,79 +1716,73 @@ msgid "" msgstr "" #. Tag: title -#: extras_topology.xml:1495 +#: extras_topology.xml:1582 #, no-c-format msgid "Topology Accessors" msgstr "" #. Tag: refname -#: extras_topology.xml:1498 +#: extras_topology.xml:1585 #, no-c-format msgid "GetEdgeByPoint" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1500 +#: extras_topology.xml:1587 #, no-c-format msgid "Find the edge-id of an edge that intersects a given point" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1505 +#: extras_topology.xml:1592 #, no-c-format msgid "integer GetEdgeByPoint varchar atopology geometry apoint float8 tol" msgstr "" #. Tag: title -#: extras_topology.xml:1516 +#: extras_topology.xml:1603 #, no-c-format msgid "Retrieve the id of an edge that intersects a Point" msgstr "" #. Tag: para -#: extras_topology.xml:1518 +#: extras_topology.xml:1605 #, no-c-format msgid "The function returns an integer (id-edge) given a topology, a POINT and a tolerance. If tolerance = 0 then the point has to intersect the edge." msgstr "" #. Tag: para -#: extras_topology.xml:1519 extras_topology.xml:1567 -#, no-c-format -msgid "If the point is the location of a node, then an exception is thrown. To avoid this run the GetNodeByPoint function." -msgstr "" - -#. Tag: para -#: extras_topology.xml:1520 +#: extras_topology.xml:1606 #, no-c-format msgid "If the point doesn't intersect an edge, returns 0 (zero)." msgstr "" #. Tag: para -#: extras_topology.xml:1521 +#: extras_topology.xml:1607 #, no-c-format msgid "If use tolerance > 0 and there is more than one edge near the point then an exception is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:1526 +#: extras_topology.xml:1612 #, no-c-format msgid "If tolerance = 0, the function use ST_Intersects otherwise uses ST_DWithin." msgstr "" #. Tag: para -#: extras_topology.xml:1529 extras_topology.xml:1576 extras_topology.xml:1623 +#: extras_topology.xml:1615 extras_topology.xml:1665 extras_topology.xml:1716 #, no-c-format msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0." msgstr "" #. Tag: para -#: extras_topology.xml:1535 extras_topology.xml:1629 +#: extras_topology.xml:1621 extras_topology.xml:1722 #, no-c-format msgid "These examples use edges we created in " msgstr "" #. Tag: programlisting -#: extras_topology.xml:1536 +#: extras_topology.xml:1622 #, no-c-format msgid "" "SELECT topology.GetEdgeByPoint('ma_topo',geom, 1) As with1mtol, topology.GetEdgeByPoint('ma_topo',geom,0) As withnotol\n" @@ -1649,7 +1793,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:1537 +#: extras_topology.xml:1623 #, no-c-format msgid "" "SELECT topology.GetEdgeByPoint('ma_topo',geom, 1) As nearnode\n" @@ -1660,67 +1804,67 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1544 +#: extras_topology.xml:1630 #, no-c-format -msgid ", " +msgid ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:1550 +#: extras_topology.xml:1640 #, no-c-format msgid "GetFaceByPoint" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1551 +#: extras_topology.xml:1641 #, no-c-format msgid "Find the face-id of a face that intersects a given point" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1555 +#: extras_topology.xml:1645 #, no-c-format msgid "integer GetFaceByPoint varchar atopology geometry apoint float8 tol" msgstr "" #. Tag: para -#: extras_topology.xml:1565 +#: extras_topology.xml:1655 #, no-c-format msgid "Retrieve the id of a face that intersects a Point." msgstr "" #. Tag: para -#: extras_topology.xml:1566 +#: extras_topology.xml:1656 #, no-c-format msgid "The function returns an integer (id-face) given a topology, a POINT and a tolerance. If tolerance = 0 then the point has to intersect the face." msgstr "" #. Tag: para -#: extras_topology.xml:1568 +#: extras_topology.xml:1657 #, no-c-format msgid "If the point doesn't intersect a face, returns 0 (zero)." msgstr "" #. Tag: para -#: extras_topology.xml:1569 +#: extras_topology.xml:1658 #, no-c-format msgid "If use tolerance > 0 and there is more than one face near the point then an exception is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:1573 +#: extras_topology.xml:1662 #, no-c-format msgid "If tolerance = 0, the function uses ST_Intersects otherwise uses ST_DWithin." msgstr "" #. Tag: para -#: extras_topology.xml:1580 +#: extras_topology.xml:1669 #, no-c-format msgid "These examples use edges faces created in " msgstr "" #. Tag: programlisting -#: extras_topology.xml:1581 +#: extras_topology.xml:1670 #, no-c-format msgid "" "SELECT topology.GetFaceByPoint('ma_topo',geom, 10) As with1mtol, topology.GetFaceByPoint('ma_topo',geom,0) As withnotol\n" @@ -1732,7 +1876,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:1582 +#: extras_topology.xml:1671 #, no-c-format msgid "" "SELECT topology.GetFaceByPoint('ma_topo',geom, 1) As nearnode\n" @@ -1743,61 +1887,61 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1587 +#: extras_topology.xml:1676 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:1593 +#: extras_topology.xml:1686 #, no-c-format msgid "GetNodeByPoint" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1595 +#: extras_topology.xml:1688 #, no-c-format msgid "Find the id of a node at a point location" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1600 +#: extras_topology.xml:1693 #, no-c-format msgid "integer GetNodeByPoint varchar atopology geometry point float8 tol" msgstr "" #. Tag: title -#: extras_topology.xml:1611 +#: extras_topology.xml:1704 #, no-c-format msgid "Retrieve the id of a node at a point location" msgstr "" #. Tag: para -#: extras_topology.xml:1613 +#: extras_topology.xml:1706 #, no-c-format msgid "The function return an integer (id-node) given a topology, a POINT and a tolerance. If tolerance = 0 mean exactly intersection otherwise retrieve the node from an interval." msgstr "" #. Tag: para -#: extras_topology.xml:1614 +#: extras_topology.xml:1707 #, no-c-format msgid "If there isn't a node at the point, it return 0 (zero)." msgstr "" #. Tag: para -#: extras_topology.xml:1615 +#: extras_topology.xml:1708 #, no-c-format msgid "If use tolerance > 0 and near the point there are more than one node it throw an exception." msgstr "" #. Tag: para -#: extras_topology.xml:1620 +#: extras_topology.xml:1713 #, no-c-format msgid "If tolerance = 0, the function use ST_Intersects otherwise will use ST_DWithin." msgstr "" #. Tag: programlisting -#: extras_topology.xml:1630 +#: extras_topology.xml:1723 #, no-c-format msgid "" "SELECT topology.GetNodeByPoint('ma_topo',geom, 1) As nearnode \n" @@ -1808,7 +1952,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:1631 +#: extras_topology.xml:1724 #, no-c-format msgid "" "SELECT topology.GetNodeByPoint('ma_topo',geom, 1000) As too_much_tolerance\n" @@ -1819,37 +1963,37 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1638 +#: extras_topology.xml:1731 #, no-c-format -msgid ", " +msgid ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:1644 +#: extras_topology.xml:1741 #, no-c-format msgid "GetTopologyID" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1646 +#: extras_topology.xml:1743 #, no-c-format msgid "Returns the id of a topology in the topology.topology table given the name of the topology." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1651 extras_topology.xml:1693 +#: extras_topology.xml:1748 extras_topology.xml:1790 #, no-c-format msgid "integer GetTopologyID varchar toponame" msgstr "" #. Tag: para -#: extras_topology.xml:1661 +#: extras_topology.xml:1758 #, no-c-format msgid "Returns the id of a topology in the topology.topology table given the name of the topology." msgstr "" #. Tag: programlisting -#: extras_topology.xml:1669 +#: extras_topology.xml:1766 #, no-c-format msgid "" "SELECT topology.GetTopologyID('ma_topo') As topo_id;\n" @@ -1859,31 +2003,31 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1675 +#: extras_topology.xml:1772 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: extras_topology.xml:1686 +#: extras_topology.xml:1783 #, no-c-format msgid "GetTopologySRID" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1688 +#: extras_topology.xml:1785 #, no-c-format msgid "Returns the SRID of a topology in the topology.topology table given the name of the topology." msgstr "" #. Tag: para -#: extras_topology.xml:1703 +#: extras_topology.xml:1800 #, no-c-format msgid "Returns the spatial reference id of a topology in the topology.topology table given the name of the topology." msgstr "" #. Tag: programlisting -#: extras_topology.xml:1711 +#: extras_topology.xml:1808 #, no-c-format msgid "" "SELECT topology.GetTopologySRID('ma_topo') As SRID;\n" @@ -1893,37 +2037,37 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1717 +#: extras_topology.xml:1814 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: extras_topology.xml:1728 +#: extras_topology.xml:1825 #, no-c-format msgid "GetTopologyName" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1730 +#: extras_topology.xml:1827 #, no-c-format msgid "Returns the name of a topology (schema) given the id of the topology." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1735 +#: extras_topology.xml:1832 #, no-c-format msgid "varchar GetTopologyName integer topology_id" msgstr "" #. Tag: para -#: extras_topology.xml:1745 +#: extras_topology.xml:1842 #, no-c-format msgid "Returns the topology name (schema) of a topology from the topology.topology table given the topology id of the topology." msgstr "" #. Tag: programlisting -#: extras_topology.xml:1753 +#: extras_topology.xml:1850 #, no-c-format msgid "" "SELECT topology.GetTopologyName(1) As topo_name;\n" @@ -1933,49 +2077,49 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1759 +#: extras_topology.xml:1856 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: extras_topology.xml:1770 +#: extras_topology.xml:1867 #, no-c-format msgid "ST_GetFaceEdges" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1772 +#: extras_topology.xml:1869 #, no-c-format msgid "Returns a set of ordered edges that bound aface." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1777 +#: extras_topology.xml:1874 #, no-c-format msgid "getfaceedges_returntype ST_GetFaceEdges varchar atopology integer aface" msgstr "" #. Tag: para -#: extras_topology.xml:1788 +#: extras_topology.xml:1885 #, no-c-format msgid "Returns a set of ordered edges that bound aface. Each output consists of a sequence and edgeid. Sequence numbers start with value 1." msgstr "" #. Tag: para -#: extras_topology.xml:1790 +#: extras_topology.xml:1887 #, no-c-format msgid "Enumeration of each ring edges start from the edge with smallest identifier. Order of edges follows a left-hand-rule (bound face is on the left of each directed edge)." msgstr "" #. Tag: para -#: extras_topology.xml:1797 +#: extras_topology.xml:1894 #, 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:1803 +#: extras_topology.xml:1900 #, no-c-format msgid "" "-- Returns the edges bounding face 1\n" @@ -1994,11 +2138,11 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:1804 +#: extras_topology.xml:1901 #, no-c-format msgid "" - "-- Returns the sequenc, edge id\n" - "-- , and geometry of the edges that bound face 1\n" + "-- Returns the sequence, edge id\n" + "-- and geometry of the edges that bound face 1\n" "-- If you just need geom and seq, can use ST_GetFaceGeometry\n" "SELECT t.seq, t.edge, geom\n" "FROM topology.ST_GetFaceEdges('tt',1) As t(seq,edge)\n" @@ -2006,43 +2150,43 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1810 +#: extras_topology.xml:1907 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:1820 +#: extras_topology.xml:1917 #, no-c-format msgid "ST_GetFaceGeometry" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1822 +#: extras_topology.xml:1919 #, no-c-format msgid "Returns the polygon in the given topology with the specified face id." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1827 +#: extras_topology.xml:1924 #, no-c-format msgid "geometry ST_GetFaceGeometry varchar atopology integer aface" msgstr "" #. Tag: para -#: extras_topology.xml:1838 +#: extras_topology.xml:1935 #, no-c-format msgid "Returns the polygon in the given topology with the specified face id. Builds the polygon from the edges making up the face." msgstr "" #. Tag: para -#: extras_topology.xml:1843 +#: extras_topology.xml:1940 #, 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:1849 +#: extras_topology.xml:1946 #, no-c-format msgid "" "-- Returns the wkt of the polygon added with AddFace\n" @@ -2057,181 +2201,193 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:1861 +#: extras_topology.xml:1958 #, no-c-format msgid "GetRingEdges" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1863 +#: extras_topology.xml:1960 #, no-c-format -msgid "Returns an ordered set of edges forming a ring with the given edge ." +msgid "Returns the ordered set of signed edge identifiers met by walking on an a given edge side." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1870 +#: extras_topology.xml:1968 #, no-c-format msgid "getfaceedges_returntype GetRingEdges varchar atopology integer aring integer max_edges=null" msgstr "" #. Tag: para -#: extras_topology.xml:1882 +#: extras_topology.xml:1980 +#, no-c-format +msgid "Returns the ordered set of signed edge identifiers met by walking on an a given edge side. Each output consists of a sequence and a signed edge id. Sequence numbers start with value 1." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1987 #, no-c-format -msgid "Returns an ordered set of edges forming a ring with the given edge. Each output consists of a sequence and a signed edge id. Sequence numbers start with value 1. A negative edge identifier means that the given edge is taken backward. You can pass a negative edge id to start walking backward." +msgid "If you pass a positive edge id, the walk starts on the left side of the corresponding edge and follows the edge direction. If you pass a negative edge id, the walk starts on the right side of it and goes backward." msgstr "" #. Tag: para -#: extras_topology.xml:1890 +#: extras_topology.xml:1994 #, no-c-format msgid "If max_edges is not null no more than those records are returned by that function. This is meant to be a safety parameter when dealing with possibly invalid topologies." msgstr "" #. Tag: para -#: extras_topology.xml:1905 +#: extras_topology.xml:2000 +#, no-c-format +msgid "This function uses edge ring linking metadata." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2012 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_topology.xml:1914 +#: extras_topology.xml:2021 #, no-c-format msgid "GetNodeEdges" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1916 +#: extras_topology.xml:2023 #, no-c-format msgid "Returns an ordered set of edges incident to the given node." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1923 +#: extras_topology.xml:2030 #, no-c-format msgid "getfaceedges_returntype GetNodeEdges varchar atopology integer anode" msgstr "" #. Tag: para -#: extras_topology.xml:1934 +#: extras_topology.xml:2041 #, no-c-format msgid "Returns an ordered set of edges incident to the given node. Each output consists of a sequence and a signed edge id. Sequence numbers start with value 1. A positive edge starts at the given node. A negative edge ends into the given node. Closed edges will appear twice (with both signs). Order is clockwise starting from northbound." msgstr "" #. Tag: para -#: extras_topology.xml:1945 +#: extras_topology.xml:2052 #, no-c-format msgid "This function computes ordering rather than deriving from metadata and is thus usable to build edge ring linking." msgstr "" #. Tag: para -#: extras_topology.xml:1958 +#: extras_topology.xml:2065 #, no-c-format msgid ", " msgstr "" #. Tag: para -#: extras_topology.xml:1971 +#: extras_topology.xml:2078 #, no-c-format msgid "This section covers the functions for processing topologies in non-standard ways." msgstr "" #. Tag: title -#: extras_topology.xml:1974 +#: extras_topology.xml:2081 #, no-c-format msgid "Topology Processing" msgstr "" #. Tag: refname -#: extras_topology.xml:1977 +#: extras_topology.xml:2084 #, no-c-format msgid "Polygonize" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1978 +#: extras_topology.xml:2085 #, no-c-format msgid "Find and register all faces defined by topology edges" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1982 +#: extras_topology.xml:2089 #, no-c-format msgid "text Polygonize varchar toponame" msgstr "" #. Tag: para -#: extras_topology.xml:1992 +#: extras_topology.xml:2099 #, no-c-format msgid "Register all faces that can be built out a topology edge primitives." msgstr "" #. Tag: para -#: extras_topology.xml:1993 +#: extras_topology.xml:2100 #, no-c-format msgid "The target topology is assumed to contain no self-intersecting edges." msgstr "" #. Tag: para -#: extras_topology.xml:1994 +#: extras_topology.xml:2101 #, no-c-format msgid "Already known faces are recognized, so it is safe to call Polygonize multiple times on the same topology." msgstr "" #. Tag: para -#: extras_topology.xml:1995 extras_topology.xml:2148 +#: extras_topology.xml:2102 extras_topology.xml:2255 #, no-c-format msgid "This function does not use nor set the next_left_edge and next_right_edge fields of the edge table." msgstr "" #. Tag: para -#: extras_topology.xml:2007 +#: extras_topology.xml:2114 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_topology.xml:2013 +#: extras_topology.xml:2120 #, no-c-format msgid "AddNode" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2015 +#: extras_topology.xml:2122 #, no-c-format msgid "Adds a point node to the node table in the specified topology schema and returns the nodeid of new node. If point already exists as node, the existing nodeid is returned." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2020 +#: extras_topology.xml:2127 #, no-c-format msgid "integer AddNode varchar toponame geometry apoint boolean allowEdgeSplitting=false boolean computeContainingFace=false" msgstr "" #. Tag: para -#: extras_topology.xml:2033 +#: extras_topology.xml:2140 #, no-c-format msgid "Adds a point node to the node table in the specified topology schema. The function automatically adds start and end points of an edge when called so not necessary to explicitly add nodes of an edge." msgstr "" #. Tag: para -#: extras_topology.xml:2040 +#: extras_topology.xml:2147 #, no-c-format msgid "If any edge crossing the node is found either an exception is raised or the edge is split, depending on the allowEdgeSplitting parameter value." msgstr "" #. Tag: para -#: extras_topology.xml:2046 +#: extras_topology.xml:2153 #, no-c-format msgid "If computeContainingFace is true a newly added node would get the correct containing face computed." msgstr "" #. Tag: para -#: extras_topology.xml:2051 +#: extras_topology.xml:2158 #, no-c-format msgid "If the apoint geometry already exists as a node, the node is not added but the existing nodeid is returned." msgstr "" #. Tag: programlisting -#: extras_topology.xml:2060 +#: extras_topology.xml:2167 #, no-c-format msgid "" "SELECT topology.AddNode('ma_topo', ST_GeomFromText('POINT(227641.6 893816.5)', 26986) ) As nodeid;\n" @@ -2242,49 +2398,49 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:2072 +#: extras_topology.xml:2179 #, no-c-format msgid "AddEdge" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2074 +#: extras_topology.xml:2181 #, no-c-format msgid "Adds a linestring edge to the edge table and associated start and end points to the point nodes table of the specified topology schema using the specified linestring geometry and returns the edgeid of the new (or existing) edge." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2079 +#: extras_topology.xml:2186 #, no-c-format msgid "integer AddEdge varchar toponame geometry aline" msgstr "" #. Tag: para -#: extras_topology.xml:2090 +#: extras_topology.xml:2197 #, no-c-format msgid "Adds an edge to the edge table and associated nodes to the nodes table of the specified toponame schema using the specified linestring geometry and returns the edgeid of the new or existing record. The newly added edge has \"universe\" face on both sides and links to itself." msgstr "" #. Tag: para -#: extras_topology.xml:2092 +#: extras_topology.xml:2199 #, no-c-format msgid "If the aline geometry crosses, overlaps, contains or is contained by an existing linestring edge, then an error is thrown and the edge is not added." msgstr "" #. Tag: para -#: extras_topology.xml:2093 +#: extras_topology.xml:2200 #, no-c-format msgid "The geometry of aline must have the same srid as defined for the topology otherwise an invalid spatial reference sys error will be thrown." msgstr "" #. Tag: para -#: extras_topology.xml:2097 +#: extras_topology.xml:2204 #, no-c-format msgid "Availability: 2.0.0 requires GEOS >= 3.3.0." msgstr "" #. Tag: programlisting -#: extras_topology.xml:2103 +#: extras_topology.xml:2210 #, no-c-format msgid "" "SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227575.8 893917.2,227591.9 893900.4)', 26986) ) As edgeid;\n" @@ -2307,67 +2463,67 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2109 +#: extras_topology.xml:2216 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_topology.xml:2115 +#: extras_topology.xml:2222 #, no-c-format msgid "AddFace" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2117 +#: extras_topology.xml:2224 #, no-c-format -msgid "Registers a face primitive to a topology and get it's identifier." +msgid "Registers a face primitive to a topology and gets its identifier." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2124 +#: extras_topology.xml:2231 #, no-c-format msgid "integer AddFace varchar toponame geometry apolygon boolean force_new=false" msgstr "" #. Tag: para -#: extras_topology.xml:2136 +#: extras_topology.xml:2243 #, no-c-format -msgid "Registers a face primitive to a topology and get it's identifier." +msgid "Registers a face primitive to a topology and gets its identifier." msgstr "" #. Tag: para -#: extras_topology.xml:2140 +#: extras_topology.xml:2247 #, no-c-format msgid "For a newly added face, the edges forming its boundaries and the ones contained in the face will be updated to have correct values in the left_face and right_face fields. Isolated nodes contained in the face will also be updated to have a correct containing_face field value." msgstr "" #. Tag: para -#: extras_topology.xml:2152 +#: extras_topology.xml:2259 #, no-c-format msgid "The target topology is assumed to be valid (containing no self-intersecting edges). An exception is raised if: The polygon boundary is not fully defined by existing edges or the polygon overlaps an existing face." msgstr "" #. Tag: para -#: extras_topology.xml:2154 +#: extras_topology.xml:2261 #, no-c-format msgid "If the apolygon geometry already exists as a face, then: if force_new is false (the default) the face id of the existing face is returned; if force_new is true a new id will be assigned to the newly registered face." msgstr "" #. Tag: para -#: extras_topology.xml:2162 +#: extras_topology.xml:2269 #, no-c-format msgid "When a new registration of an existing face is performed (force_new=true), no action will be taken to resolve dangling references to the existing face in the edge, node an relation tables, nor will the MBR field of the existing face record be updated. It is up to the caller to deal with that." msgstr "" #. Tag: para -#: extras_topology.xml:2169 +#: extras_topology.xml:2276 #, no-c-format msgid "The apolygon geometry must have the same srid as defined for the topology otherwise an invalid spatial reference sys error will be thrown." msgstr "" #. Tag: programlisting -#: extras_topology.xml:2178 +#: extras_topology.xml:2285 #, no-c-format msgid "" "-- first add the edges we use generate_series as an iterator (the below \n" @@ -2407,151 +2563,151 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2184 +#: extras_topology.xml:2291 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:2190 +#: extras_topology.xml:2297 #, no-c-format msgid "ST_Simplify" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2191 +#: extras_topology.xml:2298 #, no-c-format msgid "Returns a \"simplified\" geometry version of the given TopoGeometry using the Douglas-Peucker algorithm." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2197 +#: extras_topology.xml:2304 #, no-c-format msgid "geometry ST_Simplify TopoGeometry geomA float tolerance" msgstr "" #. Tag: para -#: extras_topology.xml:2207 +#: extras_topology.xml:2314 #, no-c-format msgid "Returns a \"simplified\" geometry version of the given TopoGeometry using the Douglas-Peucker algorithm on each component edge." msgstr "" #. Tag: para -#: extras_topology.xml:2210 +#: extras_topology.xml:2317 #, no-c-format msgid "The returned geometry may be non-simple or non-valid." msgstr "" #. Tag: para -#: extras_topology.xml:2211 +#: extras_topology.xml:2318 #, no-c-format msgid "Splitting component edges may help retaining simplicity/validity." msgstr "" #. Tag: para -#: extras_topology.xml:2213 +#: extras_topology.xml:2320 #, no-c-format msgid "Performed by the GEOS module." msgstr "" #. Tag: para -#: extras_topology.xml:2214 extras_topology.xml:2740 +#: extras_topology.xml:2321 extras_topology.xml:2847 #, no-c-format msgid "Availability: 2.1.0" msgstr "" #. Tag: para -#: extras_topology.xml:2219 +#: extras_topology.xml:2326 #, no-c-format msgid "Geometry , , , " msgstr "" #. Tag: para -#: extras_topology.xml:2229 +#: extras_topology.xml:2336 #, no-c-format msgid "This section covers the topology functions for creating new topogeometries." msgstr "" #. Tag: title -#: extras_topology.xml:2232 +#: extras_topology.xml:2339 #, no-c-format msgid "TopoGeometry Constructors" msgstr "" #. Tag: refname -#: extras_topology.xml:2235 +#: extras_topology.xml:2342 #, no-c-format msgid "CreateTopoGeom" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2237 +#: extras_topology.xml:2344 #, no-c-format msgid "Creates a new topo geometry object from topo element array - tg_type: 1:[multi]point, 2:[multi]line, 3:[multi]poly, 4:collection" msgstr "" #. Tag: funcsynopsis -#: extras_topology.xml:2241 +#: extras_topology.xml:2348 #, no-c-format msgid " topogeometry CreateTopoGeom varchar toponame integer tg_type integer layer_id topoelementarray tg_objs topogeometry CreateTopoGeom varchar toponame integer tg_type integer layer_id " msgstr "" #. Tag: para -#: extras_topology.xml:2262 +#: extras_topology.xml:2369 #, no-c-format msgid "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:2263 +#: extras_topology.xml:2370 #, no-c-format msgid "tg_type is an integer: 1:[multi]point (punctal), 2:[multi]line (lineal), 3:[multi]poly (areal), 4:collection. layer_id is the layer id in the topology.layer table." msgstr "" #. Tag: para -#: extras_topology.xml:2264 +#: extras_topology.xml:2371 #, no-c-format msgid "punctal layers are formed from set of nodes, lineal layers are formed from a set of edges, areal layers are formed from a set of faces, and collections can be formed from a mixture of nodes, edges, and faces." msgstr "" #. Tag: para -#: extras_topology.xml:2266 +#: extras_topology.xml:2373 #, no-c-format msgid "Omitting the array of components generates an empty TopoGeometry object." msgstr "" #. Tag: title -#: extras_topology.xml:2273 +#: extras_topology.xml:2380 #, no-c-format msgid "Examples: Form from existing edges" msgstr "" #. Tag: para -#: extras_topology.xml:2274 +#: extras_topology.xml:2381 #, no-c-format msgid "Create a topogeom in ri_topo schema for layer 2 (our ri_roads), of type (2) LINE, for the first edge (we loaded in ST_CreateTopoGeo." msgstr "" #. Tag: programlisting -#: extras_topology.xml:2275 +#: extras_topology.xml:2382 #, no-c-format msgid "INSERT INTO ri.ri_roads(road_name, topo) VALUES('Unknown', topology.CreateTopoGeom('ri_topo',2,2,'{{1,2}}'::topology.topoelementarray);" msgstr "" #. Tag: title -#: extras_topology.xml:2280 +#: extras_topology.xml:2387 #, no-c-format msgid "Examples: Convert an areal geometry to best guess topogeometry" msgstr "" #. Tag: para -#: extras_topology.xml:2281 +#: extras_topology.xml:2388 #, no-c-format msgid "Lets say we have geometries that should be formed from a collection of faces. We have for example blockgroups table and want to know the topo geometry of each block group. If our data was perfectly aligned, we could do this:" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2283 +#: extras_topology.xml:2390 #, no-c-format msgid "" "-- create our topo geometry column --\n" @@ -2577,7 +2733,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2285 +#: extras_topology.xml:2392 #, no-c-format msgid "" "--the world is rarely perfect allow for some error\n" @@ -2608,79 +2764,79 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2291 +#: extras_topology.xml:2398 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: extras_topology.xml:2304 extras_topology.xml:2480 +#: extras_topology.xml:2411 extras_topology.xml:2587 #, no-c-format msgid "toTopoGeom" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2306 +#: extras_topology.xml:2413 #, no-c-format msgid "Converts a simple Geometry into a topo geometry" msgstr "" #. Tag: funcsynopsis -#: extras_topology.xml:2312 +#: extras_topology.xml:2419 #, no-c-format msgid " topogeometry toTopoGeom geometry geom varchar toponame integer layer_id float8 tolerance topogeometry toTopoGeom geometry geom topogeometry topogeom float8 tolerance " msgstr "" #. Tag: para -#: extras_topology.xml:2333 +#: extras_topology.xml:2440 #, no-c-format msgid "Converts a simple Geometry into a ." msgstr "" #. Tag: para -#: extras_topology.xml:2337 +#: extras_topology.xml:2444 #, no-c-format msgid "Topological primitives required to represent the input geometry will be added to the underlying topology, possibly splitting existing ones, and they will be associated with the output TopoGeometry in the relation table." msgstr "" #. Tag: para -#: extras_topology.xml:2344 +#: extras_topology.xml:2451 #, no-c-format msgid "Existing TopoGeometry objects (with the possible exception of topogeom, if given) will retain their shapes." msgstr "" #. Tag: para -#: extras_topology.xml:2349 +#: extras_topology.xml:2456 #, no-c-format msgid "When tolerance is given it will be used to snap the input geometry to existing primitives." msgstr "" #. Tag: para -#: extras_topology.xml:2354 +#: extras_topology.xml:2461 #, no-c-format msgid "In the first form a new TopoGeometry will be created for the given layer (layer_id) of the given topology (toponame)." msgstr "" #. Tag: para -#: extras_topology.xml:2359 +#: extras_topology.xml:2466 #, no-c-format msgid "In the second form the primitives resulting from the conversion will be added to the pre-existing TopoGeometry (topogeom), possibly adding space to its final shape. To have the new shape completely replace the old one see ." msgstr "" #. Tag: para -#: extras_topology.xml:2368 +#: extras_topology.xml:2475 #, no-c-format msgid "Enhanced: 2.1.0 adds the version taking an existing TopoGeometry." msgstr "" #. Tag: para -#: extras_topology.xml:2372 +#: extras_topology.xml:2479 #, no-c-format msgid "This is a full self-contained workflow" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2373 +#: extras_topology.xml:2480 #, no-c-format msgid "" "-- do this if you don't have a topology setup already\n" @@ -2713,7 +2869,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2375 +#: extras_topology.xml:2482 #, no-c-format msgid "" "-- Shrink all TopoGeometry polygons by 10 meters\n" @@ -2731,37 +2887,37 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2381 +#: extras_topology.xml:2488 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: extras_topology.xml:2393 +#: extras_topology.xml:2500 #, no-c-format msgid "TopoElementArray_Agg" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2394 +#: extras_topology.xml:2501 #, no-c-format msgid "Returns a topoelementarray for a set of element_id, type arrays (topoelements)" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2399 +#: extras_topology.xml:2506 #, no-c-format msgid "topoelementarray TopoElementArray_Agg topoelement set tefield" msgstr "" #. Tag: para -#: extras_topology.xml:2409 +#: extras_topology.xml:2516 #, no-c-format msgid "Used to create a from a set of ." msgstr "" #. Tag: programlisting -#: extras_topology.xml:2418 +#: extras_topology.xml:2525 #, no-c-format msgid "" "SELECT topology.TopoElementArray_Agg(ARRAY[e,t]) As tea\n" @@ -2772,49 +2928,55 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2430 +#: extras_topology.xml:2529 extras_topology.xml:2649 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: para +#: extras_topology.xml:2537 #, no-c-format msgid "This section covers the topology functions for editing existing topogeometries." msgstr "" #. Tag: title -#: extras_topology.xml:2433 +#: extras_topology.xml:2540 #, no-c-format msgid "TopoGeometry Editors" msgstr "" #. Tag: refname -#: extras_topology.xml:2437 +#: extras_topology.xml:2544 #, no-c-format msgid "clearTopoGeom" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2439 +#: extras_topology.xml:2546 #, no-c-format msgid "Clears the content of a topo geometry" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2444 +#: extras_topology.xml:2551 #, no-c-format msgid "topogeometry clearTopoGeom topogeometry topogeom" msgstr "" #. Tag: para -#: extras_topology.xml:2454 +#: extras_topology.xml:2561 #, no-c-format msgid "Clears the content a turning it into an empty one. Mostly useful in conjunction with to replace the shape of existing objects and any dependent object in higher hierarchical levels." msgstr "" #. Tag: para -#: extras_topology.xml:2462 +#: extras_topology.xml:2569 #, no-c-format msgid "Availability: 2.1" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2466 +#: extras_topology.xml:2573 #, no-c-format msgid "" "-- Shrink all TopoGeometry polygons by 10 meters\n" @@ -2822,133 +2984,133 @@ msgid "" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2481 +#: extras_topology.xml:2588 #, no-c-format msgid "Adds a geometry shape to an existing topo geometry" msgstr "" #. Tag: para -#: extras_topology.xml:2485 +#: extras_topology.xml:2592 #, no-c-format msgid "Refer to " msgstr "" #. Tag: title -#: extras_topology.xml:2495 +#: extras_topology.xml:2602 #, no-c-format msgid "TopoGeometry Accessors" msgstr "" #. Tag: refname -#: extras_topology.xml:2499 +#: extras_topology.xml:2606 #, no-c-format msgid "GetTopoGeomElementArray" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2501 +#: extras_topology.xml:2608 #, no-c-format msgid "Returns a topoelementarray (an array of topoelements) containing the topological elements and type of the given TopoGeometry (primitive elements)" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2506 +#: extras_topology.xml:2613 #, no-c-format msgid "topoelementarray GetTopoGeomElementArray varchar toponame integer layer_id integer tg_id" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2514 +#: extras_topology.xml:2621 #, no-c-format msgid "topoelementarray topoelement GetTopoGeomElementArray topogeometry tg" msgstr "" #. Tag: para -#: extras_topology.xml:2524 +#: extras_topology.xml:2631 #, no-c-format msgid "Returns a containing the topological elements and type of the given TopoGeometry (primitive elements). This is similar to GetTopoGeomElements except it returns the elements as an array rather than as a dataset." msgstr "" #. Tag: para -#: extras_topology.xml:2526 extras_topology.xml:2573 +#: extras_topology.xml:2633 extras_topology.xml:2680 #, no-c-format msgid "tg_id is the topogeometry id of the topogeometry object in the topology in the layer denoted by layer_id in the topology.layer table." msgstr "" #. Tag: refname -#: extras_topology.xml:2547 +#: extras_topology.xml:2654 #, no-c-format msgid "GetTopoGeomElements" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2549 +#: extras_topology.xml:2656 #, no-c-format msgid "Returns a set of topoelement objects containing the topological element_id,element_type of the given TopoGeometry (primitive elements)" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2554 +#: extras_topology.xml:2661 #, no-c-format msgid "setof topoelement GetTopoGeomElements varchar toponame integer layer_id integer tg_id" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2562 +#: extras_topology.xml:2669 #, no-c-format msgid "setof topoelement GetTopoGeomElements topogeometry tg" msgstr "" #. Tag: para -#: extras_topology.xml:2572 +#: extras_topology.xml:2679 #, no-c-format msgid "Returns a set of element_id,element_type (topoelements) for a given topogeometry object in toponame schema." msgstr "" #. Tag: para -#: extras_topology.xml:2589 +#: extras_topology.xml:2696 #, no-c-format msgid ", " msgstr "" #. Tag: title -#: extras_topology.xml:2597 +#: extras_topology.xml:2704 #, no-c-format msgid "TopoGeometry Outputs" msgstr "" #. Tag: refname -#: extras_topology.xml:2600 +#: extras_topology.xml:2707 #, no-c-format msgid "AsGML" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2602 +#: extras_topology.xml:2709 #, no-c-format msgid "Returns the GML representation of a topogeometry." msgstr "" #. Tag: funcsynopsis -#: extras_topology.xml:2606 +#: extras_topology.xml:2713 #, no-c-format msgid " text AsGML topogeometry tg text AsGML topogeometry tg text nsprefix_in text AsGML topogeometry tg regclass visitedTable text AsGML topogeometry tg regclass visitedTable text nsprefix text AsGML topogeometry tg text nsprefix_in integer precision integer options text AsGML topogeometry tg text nsprefix_in integer precision integer options regclass visitedTable text AsGML topogeometry tg text nsprefix_in integer precision integer options regclass visitedTable text idprefix text AsGML topogeometry tg text nsprefix_in integer precision integer options regclass visitedTable text idprefix int gmlversion " msgstr "" #. Tag: para -#: extras_topology.xml:2667 +#: extras_topology.xml:2774 #, no-c-format msgid "Returns the GML representation of a topogeometry in version GML3 format. If no nsprefix_in is specified then gml is used. Pass in an empty string for nsprefix to get a non-qualified name space. The precision (default: 15) and options (default 1) parameters, if given, are passed untouched to the underlying call to ST_AsGML." msgstr "" #. Tag: para -#: extras_topology.xml:2669 +#: extras_topology.xml:2776 #, no-c-format msgid "The visitedTable parameter, if given, is used for keeping track of the visited Node and Edge elements so to use cross-references (xlink:xref) rather than duplicating definitions. The table is expected to have (at least) two integer fields: 'element_type' and 'element_id'. The calling user must have both read and write privileges on the given table. For best performance, an index should be defined on element_type and element_id, in that order. Such index would be created automatically by adding a unique constraint to the fields. Example:" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2675 +#: extras_topology.xml:2782 #, no-c-format msgid "" "CREATE TABLE visited (\n" @@ -2958,25 +3120,25 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2678 +#: extras_topology.xml:2785 #, no-c-format msgid "The idprefix parameter, if given, will be prepended to Edge and Node tag identifiers." msgstr "" #. Tag: para -#: extras_topology.xml:2680 +#: extras_topology.xml:2787 #, no-c-format msgid "The gmlver parameter, if given, will be passed to the underlying ST_AsGML. Defaults to 3." msgstr "" #. Tag: para -#: extras_topology.xml:2689 +#: extras_topology.xml:2796 #, no-c-format msgid "This uses the topo geometry we created in " msgstr "" #. Tag: programlisting -#: extras_topology.xml:2690 +#: extras_topology.xml:2797 #, no-c-format msgid "" "SELECT topology.AsGML(topo) As rdgml \n" @@ -3014,13 +3176,13 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2691 +#: extras_topology.xml:2798 #, no-c-format msgid "Same exercise as previous without namespace" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2692 +#: extras_topology.xml:2799 #, no-c-format msgid "" "SELECT topology.AsGML(topo,'') As rdgml \n" @@ -3058,55 +3220,55 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2698 +#: extras_topology.xml:2805 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_topology.xml:2703 +#: extras_topology.xml:2810 #, no-c-format msgid "AsTopoJSON" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2705 +#: extras_topology.xml:2812 #, no-c-format msgid "Returns the TopoJSON representation of a topogeometry." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2710 +#: extras_topology.xml:2817 #, no-c-format msgid "text AsTopoJSON topogeometry tg regclass edgeMapTable" msgstr "" #. Tag: para -#: extras_topology.xml:2721 +#: extras_topology.xml:2828 #, no-c-format msgid "Returns the TopoJSON representation of a topogeometry. If edgeMapTable is not null, it will be used as a lookup/storage mapping of edge identifiers to arc indices. This is to be able to allow for a compact \"arcs\" array in the final document." msgstr "" #. Tag: para -#: extras_topology.xml:2724 +#: extras_topology.xml:2831 #, no-c-format msgid "The table, if given, is expected to have an \"arc_id\" field of type \"serial\" and an \"edge_id\" of type integer; the code will query the table for \"edge_id\" so it is recommended to add an index on that field." msgstr "" #. Tag: para -#: extras_topology.xml:2729 +#: extras_topology.xml:2836 #, no-c-format msgid "Arc indices in the TopoJSONjoutput are 0-based but they are 1-based in the \"edgeMapTable\" table." msgstr "" #. Tag: para -#: extras_topology.xml:2735 +#: extras_topology.xml:2842 #, no-c-format msgid "A full TopoJSON document will be need to contain, in addition to the snippets returned by this function, the actual arcs plus some headers. See the TopoJSON specification." msgstr "" #. Tag: programlisting -#: extras_topology.xml:2752 +#: extras_topology.xml:2859 #, no-c-format msgid "" "CREATE TEMP TABLE edgemap(arc_id serial, edge_id int unique);\n" @@ -3161,79 +3323,91 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2760 +#: extras_topology.xml:2867 #, no-c-format msgid "This section lists the Topology functions used to check relationships between topogeometries and topology primitives" msgstr "" #. Tag: title -#: extras_topology.xml:2763 +#: extras_topology.xml:2870 #, no-c-format msgid "Topology Spatial Relationships" msgstr "" #. Tag: refname -#: extras_topology.xml:2766 +#: extras_topology.xml:2873 #, no-c-format msgid "Equals" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2768 extras_topology.xml:2817 +#: extras_topology.xml:2875 #, no-c-format msgid "Returns true if two topogeometries are composed of the same topology primitives." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2773 extras_topology.xml:2822 +#: extras_topology.xml:2880 #, no-c-format msgid "boolean Equals topogeometry tg1 topogeometry tg2" msgstr "" #. Tag: para -#: extras_topology.xml:2784 +#: extras_topology.xml:2891 #, no-c-format msgid "Returns true if two topogeometries are composed of the same topology primitives: faces, edges, nodes." msgstr "" #. Tag: para -#: extras_topology.xml:2788 +#: extras_topology.xml:2895 #, no-c-format msgid "This function not supported for topogeometries that are geometry collections. It also can not compare topogeometries from different topologies." msgstr "" #. Tag: para -#: extras_topology.xml:2795 extras_topology.xml:2845 +#: extras_topology.xml:2902 extras_topology.xml:2958 #, no-c-format msgid "&Z_support;" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2802 extras_topology.xml:2852 +#: extras_topology.xml:2909 extras_topology.xml:2965 #, no-c-format msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2809 +#: extras_topology.xml:2916 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_topology.xml:2815 +#: extras_topology.xml:2922 #, no-c-format msgid "Intersects" msgstr "" +#. Tag: refpurpose +#: extras_topology.xml:2924 +#, no-c-format +msgid "Returns true if any pair of primitives from the two topogeometries intersect." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:2932 +#, no-c-format +msgid "boolean Intersects topogeometry tg1 topogeometry tg2" +msgstr "" + #. Tag: para -#: extras_topology.xml:2833 +#: extras_topology.xml:2943 #, no-c-format -msgid "Returns true if two topogeometries share primitives or primitives intersect" +msgid "Returns true if any pair of primitives from the two topogeometries intersect." msgstr "" #. Tag: para -#: extras_topology.xml:2837 +#: extras_topology.xml:2950 #, no-c-format msgid "This function not supported for topogeometries that are geometry collections. It also can not compare topogeometries from different topologies. Also not currently supported for hierarchichal topogeometries (topogeometries composed of other topogeometries)." msgstr "" diff --git a/doc/po/templates/faq.xml.pot b/doc/po/templates/faq.xml.pot index b9a1c0fe3..badb880bb 100644 --- a/doc/po/templates/faq.xml.pot +++ b/doc/po/templates/faq.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -190,7 +190,7 @@ msgstr "" #. Tag: para #: faq.xml:97 #, no-c-format -msgid "You can store point, line, polygon, multipoint, multiline, multipolygon, and geometrycollections. In PostGIS 2.0 and above you can also store TINS and Polyhedral Surfaces in the basic geometry type. These are specified in the Open GIS Well Known Text Format (with XYZ,XYM,XYZM extensions). There are three data types currently supported. The standard OGC geometry data type which uses a planar coordinate system for measurement, the geography data type which uses a geodetic coordinate system (not OGC, but you'll find a similar type in Microsoft SQL Server 2008+). Only WGS 84 long lat (SRID:4326) is supported by the geography data type. The newest family member of the PostGIS spatial type family is raster for storing and analyzing raster data. Raster has its very own FAQ. Refer to and for more details." +msgid "You can store Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon, and GeometryCollection geometries. In PostGIS 2.0 and above you can also store TINS and Polyhedral Surfaces in the basic geometry type. These are specified in the Open GIS Well Known Text Format (with Z, M, and ZM extensions). There are three data types currently supported. The standard OGC geometry data type which uses a planar coordinate system for measurement, the geography data type which uses a geodetic coordinate system, with calculations on either a sphere or spheroid. The newest family member of the PostGIS spatial type family is raster for storing and analyzing raster data. Raster has its very own FAQ. Refer to and for more details." msgstr "" #. Tag: para @@ -202,7 +202,7 @@ msgstr "" #. Tag: para #: faq.xml:114 #, no-c-format -msgid "Short Answer: geography is a new data type that supports long range distances measurements, but most computations on it are currently slower than they are on geometry. If you use geography -- you don't need to learn much about planar coordinate systems. Geography is generally best if all you care about is measuring distances and lengths and you have data from all over the world. Geometry data type is an older data type that has many more functions supporting it, enjoys greater support from third party tools, and operations on it are generally faster -- sometimes as much as 10 fold faster for larger geometries. Geometry is best if you are pretty comfortable with spatial reference systems or you are dealing with localized data where all your data fits in a single spatial reference system (SRID), or you need to do a lot of spatial processing. Note: It is fairly easy to do one-off conversions between the two types to gain the benefits of each. Refer to to see what is currently supported and what is not." +msgid "Short Answer: geography is a newer data type that supports long range distances measurements, but most computations on it are slower than they are on geometry. If you use geography, you don't need to learn much about planar coordinate systems. Geography is generally best if all you care about is measuring distances and lengths and you have data from all over the world. Geometry data type is an older data type that has many more functions supporting it, enjoys greater support from third party tools, and operations on it are generally faster -- sometimes as much as 10 fold faster for larger geometries. Geometry is best if you are pretty comfortable with spatial reference systems or you are dealing with localized data where all your data fits in a single spatial reference system (SRID), or you need to do a lot of spatial processing. Note: It is fairly easy to do one-off conversions between the two types to gain the benefits of each. Refer to to see what is currently supported and what is not." msgstr "" #. Tag: para diff --git a/doc/po/templates/faq_raster.xml.pot b/doc/po/templates/faq_raster.xml.pot index 5433be7a8..0830aa9c5 100644 --- a/doc/po/templates/faq_raster.xml.pot +++ b/doc/po/templates/faq_raster.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -23,305 +23,317 @@ msgstr "" #. Tag: para #: faq_raster.xml:9 #, no-c-format +msgid "I'm getting error ERROR: RASTER_fromGDALRaster: Could not open bytea with GDAL. Check that the bytea is of a GDAL supported format. when using ST_FromGDALRaster or ERROR: rt_raster_to_gdal: Could not load the output GDAL driver when trying to use ST_AsPNG or other raster input functions." +msgstr "" + +#. Tag: para +#: faq_raster.xml:14 +#, no-c-format +msgid "As of PostGIS 2.1.3 and 2.0.5, a security change was made to by default disable all GDAL drivers and out of db rasters. The release notes are at PostGIS 2.0.6, 2.1.3 security release. In order to reenable specific drivers or all drivers and reenable out of database support, refer to ." +msgstr "" + +#. Tag: para +#: faq_raster.xml:22 +#, no-c-format msgid "Where can I find out more about the PostGIS Raster Project?" msgstr "" #. Tag: para -#: faq_raster.xml:13 +#: faq_raster.xml:26 #, no-c-format msgid "Refer to the PostGIS Raster home page." msgstr "" #. Tag: para -#: faq_raster.xml:19 +#: faq_raster.xml:32 #, no-c-format msgid "Are there any books or tutorials to get me started with this wonderful invention?" msgstr "" #. Tag: para -#: faq_raster.xml:23 +#: faq_raster.xml:36 #, no-c-format msgid "There is a full length beginner tutorial Intersecting vector buffers with large raster coverage using PostGIS Raster. Jorge has a series of blog articles on PostGIS Raster that demonstrate how to load raster data as well as cross compare to same tasks in Oracle GeoRaster. Check out Jorge's PostGIS Raster / Oracle GeoRaster Series. There is a whole chapter (more than 35 pages of content) dedicated to PostGIS Raster with free code and data downloads at PostGIS in Action - Raster chapter. You can buy PostGIS in Action now from Manning in hard-copy (significant discounts for bulk purchases) or just the E-book format. You can also buy from Amazon and various other book distributors. All hard-copy books come with a free coupon to download the E-book version." msgstr "" #. Tag: para -#: faq_raster.xml:30 +#: faq_raster.xml:43 #, no-c-format msgid "Here is a review from a PostGIS Raster user PostGIS raster applied to land classification urban forestry" msgstr "" #. Tag: para -#: faq_raster.xml:37 +#: faq_raster.xml:50 #, no-c-format msgid "How do I install Raster support in my PostGIS database?" msgstr "" #. Tag: para -#: faq_raster.xml:41 +#: faq_raster.xml:54 #, no-c-format msgid "The easiest is to download binaries for PostGIS and Raster which are currently available for windows and latest versions of Mac OSX. First you need a working PostGIS 2.0.0 or above and be running PostgreSQL 8.4, 9.0, or 9.1. Note in PostGIS 2.0 PostGIS Raster is fully integrated, so it will be compiled when you compile PostGIS." msgstr "" #. Tag: para -#: faq_raster.xml:43 +#: faq_raster.xml:56 #, no-c-format msgid "Instructions for installing and running under windows are available at How to Install and Configure PostGIS raster on windows" msgstr "" #. Tag: para -#: faq_raster.xml:44 +#: faq_raster.xml:57 #, no-c-format msgid "If you are on windows, you can compile yourself, or use the pre-compiled PostGIS Raster windows binaries. If you are on Mac OSX Leopard or Snow Leopard, there are binaries available at Kyng Chaos Mac OSX PostgreSQL/GIS binaries." msgstr "" #. Tag: para -#: faq_raster.xml:50 +#: faq_raster.xml:63 #, no-c-format msgid "Then to enable raster support in your database, run the rtpostgis.sql file in your database. To upgrade an existing install use rtpostgis_upgrade_minor..sql instead of rtpostgis.sql" msgstr "" #. Tag: para -#: faq_raster.xml:51 +#: faq_raster.xml:64 #, no-c-format msgid "For other platforms, you generally need to compile yourself. Dependencies are PostGIS and GDAL. For more details about compiling from source, please refer to Installing PostGIS Raster from source (in prior versions of PostGIS)" msgstr "" #. Tag: para -#: faq_raster.xml:57 +#: faq_raster.xml:70 #, no-c-format msgid "I get error could not load library \"C:/Program Files/PostgreSQL/8.4/lib/rtpostgis.dll\": The specified module could not be found. or could not load library on Linux when trying to run rtpostgis.sql" msgstr "" #. Tag: para -#: faq_raster.xml:62 +#: faq_raster.xml:75 #, no-c-format msgid "rtpostgis.so/dll is built with dependency on libgdal.dll/so. Make sure for Windows you have libgdal-1.dll in the bin folder of your PostgreSQL install. For Linux libgdal has to be in your path or bin folder." msgstr "" #. Tag: para -#: faq_raster.xml:64 +#: faq_raster.xml:77 #, no-c-format msgid "You may also run into different errors if you don't have PostGIS installed in your database. Make sure to install PostGIS first in your database before trying to install the raster support." msgstr "" #. Tag: para -#: faq_raster.xml:71 +#: faq_raster.xml:84 #, no-c-format msgid "How do I load Raster data into PostGIS?" msgstr "" #. Tag: para -#: faq_raster.xml:75 +#: faq_raster.xml:88 #, no-c-format msgid "The latest version of PostGIS comes packaged with a raster2pgsql raster loader executable capable of loading many kinds of rasters and also generating lower resolution overviews without any additional software. Please refer to for more details. Pre-2.0 versions came with a raster2pgsql.py that required python with numpy and GDAL. This is no longer needed." msgstr "" #. Tag: para -#: faq_raster.xml:81 +#: faq_raster.xml:94 #, no-c-format msgid "What kind of raster file formats can I load into my database?" msgstr "" #. Tag: para -#: faq_raster.xml:85 +#: faq_raster.xml:98 #, no-c-format msgid "Any that your GDAL library supports. GDAL supported formats are documented GDAL File Formats." msgstr "" #. Tag: para -#: faq_raster.xml:86 +#: faq_raster.xml:99 #, no-c-format msgid "Your particular GDAL install may not support all formats. To verify the ones supported by your particular GDAL install, you can use" msgstr "" #. Tag: programlisting -#: faq_raster.xml:87 +#: faq_raster.xml:100 #, no-c-format msgid "raster2pgsql -G" msgstr "" #. Tag: para -#: faq_raster.xml:93 +#: faq_raster.xml:106 #, no-c-format msgid "Can I export my PostGIS raster data to other raster formats?" msgstr "" #. Tag: para -#: faq_raster.xml:97 +#: faq_raster.xml:110 #, no-c-format msgid "Yes" msgstr "" #. Tag: para -#: faq_raster.xml:98 +#: faq_raster.xml:111 #, no-c-format msgid "GDAL 1.7+ has a PostGIS raster driver, but is only compiled in if you choose to compile with PostgreSQL support." msgstr "" #. Tag: para -#: faq_raster.xml:99 +#: faq_raster.xml:112 #, no-c-format msgid "The driver currently doesn't support irregularly blocked rasters, although you can store irregularly blocked rasters in PostGIS raster data type." msgstr "" #. Tag: para -#: faq_raster.xml:101 +#: faq_raster.xml:114 #, no-c-format msgid "If you are compiling from source, you need to include in your configure --with-pg=path/to/pg_config to enable the driver. Refer to GDAL Build Hints for tips on building GDAL against in various OS platforms." msgstr "" #. Tag: para -#: faq_raster.xml:106 +#: faq_raster.xml:119 #, no-c-format msgid "If your version of GDAL is compiled with the PostGIS Raster driver you should see PostGIS Raster in list when you do" msgstr "" #. Tag: programlisting -#: faq_raster.xml:108 +#: faq_raster.xml:121 #, no-c-format msgid "gdalinfo --formats" msgstr "" #. Tag: para -#: faq_raster.xml:110 +#: faq_raster.xml:123 #, no-c-format msgid "To get a summary about your raster via GDAL use gdalinfo:" msgstr "" #. Tag: programlisting -#: faq_raster.xml:111 +#: faq_raster.xml:124 #, no-c-format msgid "gdalinfo \"PG:host=localhost port=5432 dbname='mygisdb' user='postgres' password='whatever' schema='someschema' table=sometable\"" msgstr "" #. Tag: para -#: faq_raster.xml:114 +#: faq_raster.xml:127 #, no-c-format msgid "To export data to other raster formats, use gdal_translate the below will export all data from a table to a PNG file at 10% size." msgstr "" #. Tag: para -#: faq_raster.xml:116 +#: faq_raster.xml:129 #, no-c-format msgid "Depending on your pixel band types, some translations may not work if the export format does not support that Pixel type. For example floating point band types and 32 bit unsigned ints will not translate easily to JPG or some others." msgstr "" #. Tag: para -#: faq_raster.xml:119 +#: faq_raster.xml:132 #, no-c-format msgid "Here is an example simple translation" msgstr "" #. Tag: programlisting -#: faq_raster.xml:120 +#: faq_raster.xml:133 #, no-c-format msgid "gdal_translate -of PNG -outsize 10% 10% \"PG:host=localhost port=5432 dbname='mygisdb' user='postgres' password='whatever' schema='someschema' table=sometable\" C:\\somefile.png" msgstr "" #. Tag: para -#: faq_raster.xml:121 +#: faq_raster.xml:134 #, no-c-format msgid "You can also use SQL where clauses in your export using the where=... in your driver connection string. Below are some using a where clause" msgstr "" #. Tag: programlisting -#: faq_raster.xml:123 +#: faq_raster.xml:136 #, no-c-format msgid "gdal_translate -of PNG -outsize 10% 10% \"PG:host=localhost port=5432 dbname='mygisdb' user='postgres' password='whatever' schema='someschema' table=sometable where='filename=\\'abcd.sid\\''\" \" C:\\somefile.png" msgstr "" #. Tag: programlisting -#: faq_raster.xml:124 +#: faq_raster.xml:137 #, no-c-format msgid "gdal_translate -of PNG -outsize 10% 10% \"PG:host=localhost port=5432 dbname='mygisdb' user='postgres' password='whatever' schema='someschema' table=sometable where='ST_Intersects(rast, ST_SetSRID(ST_Point(-71.032,42.3793),4326) )' \" C:\\intersectregion.png" msgstr "" #. Tag: para -#: faq_raster.xml:125 +#: faq_raster.xml:138 #, no-c-format msgid "To see more examples and syntax refer to Reading Raster Data of PostGIS Raster section" msgstr "" #. Tag: para -#: faq_raster.xml:130 +#: faq_raster.xml:143 #, no-c-format msgid "Are their binaries of GDAL available already compiled with PostGIS Raster suppport?" msgstr "" #. Tag: para -#: faq_raster.xml:132 +#: faq_raster.xml:145 #, no-c-format msgid "Yes. Check out the page GDAL Binaries page. Any compiled with PostgreSQL support should have PostGIS Raster in them." msgstr "" #. Tag: para -#: faq_raster.xml:134 +#: faq_raster.xml:147 #, no-c-format msgid "PostGIS Raster is undergoing many changes. If you want to get the latest nightly build for Windows -- then check out the Tamas Szekeres nightly builds built with Visual Studio which contain GDAL trunk, Python Bindings and MapServer executables and PostGIS Raster driver built-in. Just click the SDK bat and run your commands from there. http://vbkto.dyndns.org/sdk/. Also available are VS project files." msgstr "" #. Tag: para -#: faq_raster.xml:138 +#: faq_raster.xml:151 #, no-c-format msgid "FWTools latest stable version for Windows is compiled with Raster support." msgstr "" #. Tag: para -#: faq_raster.xml:144 +#: faq_raster.xml:157 #, no-c-format msgid "What tools can I use to view PostGIS raster data?" msgstr "" #. Tag: para -#: faq_raster.xml:148 +#: faq_raster.xml:161 #, no-c-format msgid "You can use MapServer compiled with GDAL 1.7+ and PostGIS Raster driver support to view Raster data. QuantumGIS (QGIS) now supports viewing of PostGIS Raster if you have PostGIS raster driver installed." msgstr "" #. Tag: para -#: faq_raster.xml:150 +#: faq_raster.xml:163 #, no-c-format msgid "In theory any tool that renders data using GDAL can support PostGIS raster data or support it with fairly minimal effort. Again for Windows, Tamas' binaries http://vbkto.dyndns.org/sdk/ are a good choice if you don't want the hassle of having to setup to compile your own." msgstr "" #. Tag: para -#: faq_raster.xml:157 +#: faq_raster.xml:170 #, no-c-format msgid "How can I add a PostGIS raster layer to my MapServer map?" msgstr "" #. Tag: para -#: faq_raster.xml:161 +#: faq_raster.xml:174 #, no-c-format msgid "First you need GDAL 1.7 or higher compiled with PostGIS raster support. GDAL 1.8 or above is preferred since many issues have been fixed in 1.8 and more PostGIS raster issues fixed in trunk version." msgstr "" #. Tag: para -#: faq_raster.xml:163 +#: faq_raster.xml:176 #, no-c-format msgid "You can much like you can with any other raster. Refer to MapServer Raster processing options for list of various processing functions you can use with MapServer raster layers." msgstr "" #. Tag: para -#: faq_raster.xml:166 +#: faq_raster.xml:179 #, no-c-format msgid "What makes PostGIS raster data particularly interesting, is that since each tile can have various standard database columns, you can segment it in your data source" msgstr "" #. Tag: para -#: faq_raster.xml:168 +#: faq_raster.xml:181 #, no-c-format msgid "Below is an example of how you would define a PostGIS raster layer in MapServer." msgstr "" #. Tag: para -#: faq_raster.xml:169 +#: faq_raster.xml:182 #, no-c-format msgid "The mode=2 is required for tiled rasters and was added in PostGIS 2.0 and GDAL 1.8 drivers. This does not exist in GDAL 1.7 drivers." msgstr "" #. Tag: programlisting -#: faq_raster.xml:170 +#: faq_raster.xml:183 #, no-c-format msgid "" "-- displaying raster with standard raster options\n" @@ -354,7 +366,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: faq_raster.xml:172 +#: faq_raster.xml:185 #, no-c-format msgid "" "-- displaying raster with standard raster options and a where clause\n" @@ -371,43 +383,43 @@ msgid "" msgstr "" #. Tag: para -#: faq_raster.xml:180 +#: faq_raster.xml:193 #, no-c-format msgid "What functions can I currently use with my raster data?" msgstr "" #. Tag: para -#: faq_raster.xml:184 +#: faq_raster.xml:197 #, no-c-format msgid "Refer to the list of . There are more, but this is still a work in progress." msgstr "" #. Tag: para -#: faq_raster.xml:186 +#: faq_raster.xml:199 #, no-c-format msgid "Refer to the PostGIS Raster roadmap page for details of what you can expect in the future." msgstr "" #. Tag: para -#: faq_raster.xml:194 +#: faq_raster.xml:207 #, no-c-format msgid "I am getting error ERROR: function st_intersects(raster, unknown) is not unique or st_union(geometry,text) is not unique. How do I fix?" msgstr "" #. Tag: para -#: faq_raster.xml:198 +#: faq_raster.xml:211 #, no-c-format msgid "The function is not unique error happens if one of your arguments is a textual representation of a geometry instead of a geometry. In these cases, PostgreSQL marks the textual representation as an unknown type, which means it can fall into the st_intersects(raster, geometry) or st_intersects(raster,raster) thus resulting in a non-unique case since both functions can in theory support your request. To prevent this, you need to cast the geometry to a geometry." msgstr "" #. Tag: para -#: faq_raster.xml:199 +#: faq_raster.xml:212 #, no-c-format msgid "For example if your code looks like this:" msgstr "" #. Tag: programlisting -#: faq_raster.xml:200 +#: faq_raster.xml:213 #, no-c-format msgid "" "SELECT rast\n" @@ -416,13 +428,13 @@ msgid "" msgstr "" #. Tag: para -#: faq_raster.xml:201 +#: faq_raster.xml:214 #, no-c-format msgid "Cast the textual geometry representation to a geometry by changing your code to this:" msgstr "" #. Tag: programlisting -#: faq_raster.xml:202 +#: faq_raster.xml:215 #, no-c-format msgid "" "SELECT rast\n" @@ -431,91 +443,91 @@ msgid "" msgstr "" #. Tag: para -#: faq_raster.xml:208 +#: faq_raster.xml:221 #, no-c-format msgid "How is PostGIS Raster different from Oracle GeoRaster (SDO_GEORASTER) and SDO_RASTER types?" msgstr "" #. Tag: para -#: faq_raster.xml:212 +#: faq_raster.xml:225 #, no-c-format msgid "For a more extensive discussion on this topic, check out Jorge Arévalo Oracle GeoRaster and PostGIS Raster: First impressions " msgstr "" #. Tag: para -#: faq_raster.xml:213 +#: faq_raster.xml:226 #, no-c-format msgid "The major advantage of one-georeference-by-raster over one-georeference-by-layer is to allow:" msgstr "" #. Tag: para -#: faq_raster.xml:214 +#: faq_raster.xml:227 #, no-c-format msgid "* coverages to be not necessarily rectangular (which is often the case of raster coverage covering large extents. See the possible raster arrangements in the documentation)" msgstr "" #. Tag: para -#: faq_raster.xml:215 +#: faq_raster.xml:228 #, no-c-format msgid "* rasters to overlaps (which is necessary to implement lossless vector to raster conversion)" msgstr "" #. Tag: para -#: faq_raster.xml:216 +#: faq_raster.xml:229 #, no-c-format msgid "These arrangements are possible in Oracle as well, but they imply the storage of multiple SDO_GEORASTER objects linked to as many SDO_RASTER tables. A complex coverage can lead to hundreds of tables in the database. With PostGIS Raster you can store a similar raster arrangement into a unique table." msgstr "" #. Tag: para -#: faq_raster.xml:221 +#: faq_raster.xml:234 #, no-c-format msgid "It's a bit like if PostGIS would force you to store only full rectangular vector coverage without gaps or overlaps (a perfect rectangular topological layer). This is very practical in some applications but practice has shown that it is not realistic or desirable for most geographical coverages. Vector structures needs the flexibility to store discontinuous and non-rectangular coverages. We think it is a big advantage that raster structure should benefit as well." msgstr "" #. Tag: para -#: faq_raster.xml:229 +#: faq_raster.xml:242 #, no-c-format msgid "raster2pgsql load of large file fails with String of N bytes is too long for encoding conversion?" msgstr "" #. Tag: para -#: faq_raster.xml:233 +#: faq_raster.xml:246 #, no-c-format msgid "raster2pgsql doesn't make any connections to your database when generating the file to load. If your database has set an explicit client encoding different from your database encoding, then when loading large raster files (above 30 MB in size), you may run into a bytes is too long for encoding conversion." msgstr "" #. Tag: para -#: faq_raster.xml:235 +#: faq_raster.xml:248 #, no-c-format msgid "This generally happens if for example you have your database in UTF8, but to support windows apps, you have the client encoding set to WIN1252." msgstr "" #. Tag: para -#: faq_raster.xml:236 +#: faq_raster.xml:249 #, no-c-format msgid "To work around this make sure the client encoding is the same as your database encoding during load. You can do this by explicitly setting the encoding in your load script. Example, if you are on windows:" msgstr "" #. Tag: programlisting -#: faq_raster.xml:237 +#: faq_raster.xml:250 #, no-c-format msgid "set PGCLIENTENCODING=UTF8" msgstr "" #. Tag: para -#: faq_raster.xml:238 +#: faq_raster.xml:251 #, no-c-format msgid "If you are on Unix/Linux" msgstr "" #. Tag: programlisting -#: faq_raster.xml:239 +#: faq_raster.xml:252 #, no-c-format msgid "export PGCLIENTENCODING=UTF8" msgstr "" #. Tag: para -#: faq_raster.xml:240 +#: faq_raster.xml:253 #, no-c-format msgid "Gory details of this issue are detailed in http://trac.osgeo.org/postgis/ticket/2209" msgstr "" diff --git a/doc/po/templates/installation.xml.pot b/doc/po/templates/installation.xml.pot index 4f7463f73..da36d2327 100644 --- a/doc/po/templates/installation.xml.pot +++ b/doc/po/templates/installation.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -67,9 +67,16 @@ msgstr "" msgid "" "psql -d yourdatabase -c \"CREATE EXTENSION postgis;\"\n" "psql -d yourdatabase -c \"CREATE EXTENSION postgis_topology;\"\n" - "psql -d yourdatabase -c \"CREATE EXTENSION postgis_tiger_geocoder;\"\n" "-- if you built with sfcgal support --\n" - "psql -d yourdatabase -c \"CREATE EXTENSION postgis_sfcgal;\"" + "psql -d yourdatabase -c \"CREATE EXTENSION postgis_sfcgal;\"\n" + "\n" + "-- if you want to install tiger geocoder --\n" + "psql -d yourdatabase -c \"CREATE EXTENSION fuzzystrmatch\"\n" + "psql -d yourdatabase -c \"CREATE EXTENSION postgis_tiger_geocoder;\"\n" + "\n" + "-- if you installed with pcre \n" + "-- you should have address standardizer extension as well\n" + "psql -d yourdatabase -c \"CREATE EXTENSION address_standardizer;\"" msgstr "" #. Tag: para @@ -114,152 +121,224 @@ msgstr "" msgid "The rest of this chapter goes into detail each of the above installation steps." msgstr "" +#. Tag: para +#: installation.xml:31 +#, no-c-format +msgid "As of PostGIS 2.1.3, out-of-db rasters and all raster drivers are disabled by default. In order to re-enable these, you need to set the following environment variables: POSTGIS_GDAL_ENABLED_DRIVERS and POSTGIS_ENABLE_OUTDB_RASTERS in the server environment." +msgstr "" + +#. Tag: para +#: installation.xml:34 +#, no-c-format +msgid "If you want to enable offline raster:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:35 +#, no-c-format +msgid "POSTGIS_ENABLE_OUTDB_RASTERS=1" +msgstr "" + +#. Tag: para +#: installation.xml:36 +#, no-c-format +msgid "Any other setting or no setting at all will disable out of db rasters." +msgstr "" + +#. Tag: para +#: installation.xml:37 +#, no-c-format +msgid "In order to enable all GDAL drivers available in your GDAL install, set this environment variable as follows" +msgstr "" + +#. Tag: programlisting +#: installation.xml:38 +#, no-c-format +msgid "POSTGIS_GDAL_ENABLED_DRIVERS=ENABLE_ALL" +msgstr "" + +#. Tag: para +#: installation.xml:39 +#, no-c-format +msgid "If you want to only enable specific drivers, set your environment variable as follows:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:40 +#, no-c-format +msgid "POSTGIS_GDAL_ENABLED_DRIVERS=\"GTiff PNG JPEG GIF XYZ\"" +msgstr "" + +#. Tag: para +#: installation.xml:42 +#, no-c-format +msgid "If you are on windows, do not quote the driver list" +msgstr "" + +#. Tag: para +#: installation.xml:44 +#, no-c-format +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/9.3/main/environment where 9.3 refers to version of PostgreSQL and main refers to the cluster." +msgstr "" + +#. Tag: para +#: installation.xml:47 +#, no-c-format +msgid "On windows, if you are running as a service, you can set via System variables which for Windows 7 you can get to by right-clicking on Computer->Properties Advanced System Settings or in explorer navigating to Control Panel\\All Control Panel Items\\System. Then clicking Advanced System Settings ->Advanced->Environment Variables and adding new system variables." +msgstr "" + +#. Tag: para +#: installation.xml:49 +#, no-c-format +msgid "After you set the environment variables, you'll need to restart your PostgreSQL service for the changes to take effect." +msgstr "" + #. Tag: title -#: installation.xml:33 +#: installation.xml:53 #, no-c-format msgid "Install Requirements" msgstr "" #. Tag: para -#: installation.xml:35 +#: installation.xml:55 #, no-c-format msgid "PostGIS has the following requirements for building and usage:" msgstr "" #. Tag: emphasis -#: installation.xml:40 +#: installation.xml:60 #, no-c-format msgid "Required" msgstr "" #. Tag: para -#: installation.xml:45 +#: installation.xml:65 #, no-c-format msgid "PostgreSQL &min_postgres_version; or higher. A complete installation of PostgreSQL (including server headers) is required. PostgreSQL is available from http://www.postgresql.org ." msgstr "" #. Tag: para -#: installation.xml:54 +#: installation.xml:74 #, no-c-format msgid "For a full PostgreSQL / PostGIS support matrix and PostGIS/GEOS support matrix refer to http://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS" msgstr "" #. Tag: para -#: installation.xml:60 +#: installation.xml:80 #, no-c-format msgid "GNU C compiler (gcc). Some other ANSI C compilers can be used to compile PostGIS, but we find far fewer problems when compiling with gcc." msgstr "" #. Tag: para -#: installation.xml:68 +#: installation.xml:88 #, no-c-format msgid "GNU Make (gmake or make). For many systems, GNU make is the default version of make. Check the version by invoking make -v. Other versions of make may not process the PostGIS Makefile properly." msgstr "" #. Tag: para -#: installation.xml:78 +#: installation.xml:98 #, no-c-format msgid "Proj4 reprojection library, version 4.6.0 or greater. The Proj4 library is used to provide coordinate reprojection support within PostGIS. Proj4 is available for download from http://trac.osgeo.org/proj/ ." msgstr "" #. Tag: para -#: installation.xml:90 +#: installation.xml:110 #, no-c-format -msgid "GEOS geometry library, version 3.3 or greater, but GEOS 3.4+ is recommended to take full advantage of all the new functions and features. Without GEOS 3.4, you will be missing some major enhancements such as ST_Triangles and long-running function interruption, and improvements to geometry validation and making geometries valid such as ST_ValidDetail and ST_MakeValid. GEOS 3.3.2+ is also required for topology support. GEOS is available for download from http://trac.osgeo.org/geos/ and 3.4+ is backward-compatible with older versions so fairly safe to upgrade." +msgid "GEOS geometry library, version 3.3 or greater, but GEOS 3.5+ is recommended to take full advantage of all the new functions and features. Without GEOS 3.5, you will be missing some major enhancements such as and . GEOS is available for download from http://trac.osgeo.org/geos/ and 3.4+ is backward-compatible with older versions so fairly safe to upgrade." msgstr "" #. Tag: para -#: installation.xml:100 +#: installation.xml:119 #, no-c-format msgid "LibXML2, version 2.5.x or higher. LibXML2 is currently used in some imports functions (ST_GeomFromGML and ST_GeomFromKML). LibXML2 is available for download from http://xmlsoft.org/downloads.html." msgstr "" #. Tag: para -#: installation.xml:107 +#: installation.xml:126 #, no-c-format msgid "JSON-C, version 0.9 or higher. JSON-C is currently used to import GeoJSON via the function ST_GeomFromGeoJson. JSON-C is available for download from https://github.com/json-c/json-c/releases/." msgstr "" #. Tag: para -#: installation.xml:115 +#: installation.xml:134 #, no-c-format msgid "GDAL, version 1.8 or higher (1.9 or higher is strongly recommended since some things will not work well or behavior differently with lower versions). This is required for raster support and to be able to install with CREATE EXTENSION postgis so highly recommended for those running 9.1+. http://trac.osgeo.org/gdal/wiki/DownloadSource." msgstr "" #. Tag: emphasis -#: installation.xml:123 +#: installation.xml:142 #, no-c-format msgid "Optional" msgstr "" #. Tag: para -#: installation.xml:128 +#: installation.xml:147 #, no-c-format msgid "GDAL (pseudo optional) only if you don't want raster and don't care about installing with CREATE EXTENSION postgis can you leave it out. Keep in mind other extensions may have a requires postgis extension which will prevent you from installing them unless you install postgis as an extension. So it is highly recommended you compile with GDAL support." msgstr "" #. Tag: para -#: installation.xml:134 +#: installation.xml:151 #, no-c-format -msgid "GTK (requires GTK+2.0, 2.8+) to compile the shp2pgsql-gui shape file loader. http://www.gtk.org/ ." +msgid "Also make sure to enable the drivers you want to use as described in ." msgstr "" #. Tag: para -#: installation.xml:144 +#: installation.xml:154 #, no-c-format -msgid "SFCGAL, version 1.0 (or higher) could be used to provide additional 2D and 3D advanced analysis functions to PostGIS cf . And also allow to use SFCGAL rather than GEOS for some 2D functions provided by both backends (like ST_Intersection or ST_Area, for instance). A PostgreSQL configuration variable postgis.backend allow end user to control which backend he want to use if SFCGAL is installed (GEOS by default). Nota: SFCGAL 1.0 require at least CGAL 4.1 and Boost 1.46 (cf: http://oslandia.github.io/SFCGAL/installation.html) https://github.com/Oslandia/SFCGAL." +msgid "GTK (requires GTK+2.0, 2.8+) to compile the shp2pgsql-gui shape file loader. http://www.gtk.org/ ." msgstr "" #. Tag: para -#: installation.xml:152 +#: installation.xml:164 #, no-c-format -msgid "In order to build the you will also need PCRE http://www.pcre.org (which generally is already installed on nix systems). Regex::Assemble perl CPAN package is only needed if you want to rebuild the data encoded in parseaddress-stcities.h. will automatically be built if it detects a PCRE library, or you pass in a valid --with-pcre-dir=/path/to/pcre during configure." +msgid "SFCGAL, version 1.1 (or higher) could be used to provide additional 2D and 3D advanced analysis functions to PostGIS cf . And also allow to use SFCGAL rather than GEOS for some 2D functions provided by both backends (like ST_Intersection or ST_Area, for instance). A PostgreSQL configuration variable postgis.backend allow end user to control which backend he want to use if SFCGAL is installed (GEOS by default). Nota: SFCGAL 1.2 require at least CGAL 4.3 and Boost 1.54 (cf: http://oslandia.github.io/SFCGAL/installation.html) https://github.com/Oslandia/SFCGAL." msgstr "" #. Tag: para -#: installation.xml:159 +#: installation.xml:172 #, no-c-format -msgid "CUnit (CUnit). This is needed for regression testing. http://cunit.sourceforge.net/" +msgid "In order to build the you will also need PCRE http://www.pcre.org (which generally is already installed on nix systems). Regex::Assemble perl CPAN package is only needed if you want to rebuild the data encoded in parseaddress-stcities.h. will automatically be built if it detects a PCRE library, or you pass in a valid --with-pcre-dir=/path/to/pcre during configure." msgstr "" #. Tag: para -#: installation.xml:165 +#: installation.xml:179 #, no-c-format -msgid "Apache Ant (ant) is required for building any of the drivers under the java directory. Ant is available from http://ant.apache.org ." +msgid "CUnit (CUnit). This is needed for regression testing. http://cunit.sourceforge.net/" msgstr "" #. Tag: para -#: installation.xml:177 +#: installation.xml:185 #, no-c-format msgid "DocBook (xsltproc) is required for building the documentation. Docbook is available from http://www.docbook.org/ ." msgstr "" #. Tag: para -#: installation.xml:188 +#: installation.xml:196 #, no-c-format msgid "DBLatex (dblatex) is required for building the documentation in PDF format. DBLatex is available from http://dblatex.sourceforge.net/ ." msgstr "" #. Tag: para -#: installation.xml:199 +#: installation.xml:207 #, no-c-format msgid "ImageMagick (convert) is required to generate the images used in the documentation. ImageMagick is available from http://www.imagemagick.org/ ." msgstr "" #. Tag: title -#: installation.xml:212 +#: installation.xml:220 #, no-c-format msgid "Getting the Source" msgstr "" #. Tag: para -#: installation.xml:214 +#: installation.xml:222 #, no-c-format msgid "Retrieve the PostGIS source archive from the downloads website &postgis_download_url; " msgstr "" #. Tag: programlisting -#: installation.xml:221 +#: installation.xml:229 #, no-c-format msgid "" "wget &postgis_download_url;\n" @@ -267,307 +346,307 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:223 +#: installation.xml:231 #, no-c-format msgid "This will create a directory called postgis-&last_release_version; in the current working directory." msgstr "" #. Tag: para -#: installation.xml:229 +#: installation.xml:237 #, no-c-format msgid "Alternatively, checkout the source from the svn repository http://svn.osgeo.org/postgis/trunk/ ." msgstr "" #. Tag: programlisting -#: installation.xml:241 +#: installation.xml:249 #, no-c-format msgid "svn checkout http://svn.osgeo.org/postgis/trunk/ postgis-&last_release_version;" msgstr "" #. Tag: para -#: installation.xml:243 +#: installation.xml:251 #, no-c-format msgid "Change into the newly created postgis-&last_release_version; directory to continue the installation." msgstr "" #. Tag: title -#: installation.xml:251 +#: installation.xml:259 #, no-c-format msgid "Compiling and Install from Source: Detailed" msgstr "" #. Tag: para -#: installation.xml:254 +#: installation.xml:262 #, no-c-format msgid "Many OS systems now include pre-built packages for PostgreSQL/PostGIS. In many cases compilation is only necessary if you want the most bleeding edge versions or you are a package maintainer." msgstr "" #. Tag: para -#: installation.xml:259 +#: installation.xml:267 #, no-c-format msgid "This section includes general compilation instructions, if you are compiling for Windows etc or another OS, you may find additional more detailed help at PostGIS User contributed compile guides and PostGIS Dev Wiki." msgstr "" #. Tag: para -#: installation.xml:261 +#: installation.xml:269 #, no-c-format msgid "Pre-Built Packages for various OS are listed in PostGIS Pre-built Packages" msgstr "" #. Tag: para -#: installation.xml:262 +#: installation.xml:270 #, no-c-format msgid "If you are a windows user, you can get stable builds via Stackbuilder or 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:267 +#: installation.xml:275 #, no-c-format msgid "The PostGIS module is an extension to the PostgreSQL backend server. As such, PostGIS &last_release_version; requires full PostgreSQL server headers access in order to compile. It can be built against PostgreSQL versions &min_postgres_version; or higher. Earlier versions of PostgreSQL are not supported." msgstr "" #. Tag: para -#: installation.xml:275 +#: installation.xml:283 #, no-c-format msgid "Refer to the PostgreSQL installation guides if you haven't already installed PostgreSQL. http://www.postgresql.org ." msgstr "" #. Tag: para -#: installation.xml:285 +#: installation.xml:293 #, no-c-format msgid "For GEOS functionality, when you install PostgresSQL you may need to explicitly link PostgreSQL against the standard C++ library:" msgstr "" #. Tag: programlisting -#: installation.xml:290 +#: installation.xml:298 #, no-c-format msgid "LDFLAGS=-lstdc++ ./configure [YOUR OPTIONS HERE]" msgstr "" #. Tag: para -#: installation.xml:292 +#: installation.xml:300 #, no-c-format msgid "This is a workaround for bogus C++ exceptions interaction with older development tools. If you experience weird problems (backend unexpectedly closed or similar things) try this trick. This will require recompiling your PostgreSQL from scratch, of course." msgstr "" #. Tag: para -#: installation.xml:300 +#: installation.xml:308 #, no-c-format msgid "The following steps outline the configuration and compilation of the PostGIS source. They are written for Linux users and will not work on Windows or Mac." msgstr "" #. Tag: title -#: installation.xml:307 +#: installation.xml:315 #, no-c-format msgid "Configuration" msgstr "" #. Tag: para -#: installation.xml:309 +#: installation.xml:317 #, no-c-format msgid "As with most linux installations, the first step is to generate the Makefile that will be used to build the source code. This is done by running the shell script" msgstr "" #. Tag: para -#: installation.xml:319 +#: installation.xml:327 #, no-c-format msgid "With no additional parameters, this command will attempt to automatically locate the required components and libraries needed to build the PostGIS source code on your system. Although this is the most common usage of ./configure, the script accepts several parameters for those who have the required libraries and programs in non-standard locations." msgstr "" #. Tag: para -#: installation.xml:328 +#: installation.xml:336 #, no-c-format msgid "The following list shows only the most commonly used parameters. For a complete list, use the --help or --help=short parameters." msgstr "" #. Tag: para -#: installation.xml:338 +#: installation.xml:346 #, no-c-format msgid "This is the location the PostGIS libraries and SQL scripts will be installed to. By default, this location is the same as the detected PostgreSQL installation." msgstr "" #. Tag: para -#: installation.xml:345 +#: installation.xml:353 #, no-c-format msgid "This parameter is currently broken, as the package will only install into the PostgreSQL installation directory. Visit http://trac.osgeo.org/postgis/ticket/635 to track this bug." msgstr "" #. Tag: para -#: installation.xml:360 +#: installation.xml:368 #, no-c-format msgid "PostgreSQL provides a utility called pg_config to enable extensions like PostGIS to locate the PostgreSQL installation directory. Use this parameter (--with-pgconfig=/path/to/pg_config) to manually specify a particular PostgreSQL installation that PostGIS will build against." msgstr "" #. Tag: para -#: installation.xml:374 +#: installation.xml:382 #, no-c-format msgid "GDAL, a required library, provides functionality needed for raster support gdal-config to enable software installations to locate the GDAL installation directory. Use this parameter (--with-gdalconfig=/path/to/gdal-config) to manually specify a particular GDAL installation that PostGIS will build against." msgstr "" #. Tag: para -#: installation.xml:388 +#: installation.xml:396 #, no-c-format msgid "GEOS, a required geometry library, provides a utility called geos-config to enable software installations to locate the GEOS installation directory. Use this parameter (--with-geosconfig=/path/to/geos-config) to manually specify a particular GEOS installation that PostGIS will build against." msgstr "" #. Tag: para -#: installation.xml:402 +#: installation.xml:410 #, no-c-format msgid "LibXML is the library required for doing GeomFromKML/GML processes. It normally is found if you have libxml installed, but if not or you want a specific version used, you'll need to point PostGIS at a specific xml2-config confi file to enable software installations to locate the LibXML installation directory. Use this parameter (>--with-xml2config=/path/to/xml2-config) to manually specify a particular LibXML installation that PostGIS will build against." msgstr "" #. Tag: para -#: installation.xml:420 +#: installation.xml:428 #, no-c-format msgid "Proj4 is a reprojection library required by PostGIS. Use this parameter (--with-projdir=/path/to/projdir) to manually specify a particular Proj4 installation directory that PostGIS will build against." msgstr "" #. Tag: para -#: installation.xml:432 +#: installation.xml:440 #, no-c-format msgid "Directory where iconv is installed." msgstr "" #. Tag: para -#: installation.xml:441 +#: installation.xml:449 #, no-c-format msgid "JSON-C is an MIT-licensed JSON library required by PostGIS ST_GeomFromJSON support. Use this parameter (--with-jsondir=/path/to/jsondir) to manually specify a particular JSON-C installation directory that PostGIS will build against." msgstr "" #. Tag: para -#: installation.xml:453 +#: installation.xml:461 #, no-c-format msgid "PCRE is an BSD-licensed Perl Compatible Regular Expression library required by address_standardizer extension. Use this parameter (--with-pcredir=/path/to/pcredir) to manually specify a particular PCRE installation directory that PostGIS will build against." msgstr "" #. Tag: para -#: installation.xml:465 +#: installation.xml:473 #, no-c-format msgid "Compile the data import GUI (requires GTK+2.0). This will create shp2pgsql-gui graphical interface to shp2pgsql." msgstr "" #. Tag: para -#: installation.xml:474 +#: installation.xml:482 #, no-c-format msgid "Compile with raster support. This will build rtpostgis-&last_release_version; library and rtpostgis.sql file. This may not be required in final release as plan is to build in raster support by default." msgstr "" #. Tag: para -#: installation.xml:483 +#: installation.xml:491 #, no-c-format msgid "Compile with topology support. This will build the topology.sql file. There is no corresponding library as all logic needed for topology is in postgis-&last_release_version; library." msgstr "" #. Tag: para -#: installation.xml:492 +#: installation.xml:500 #, no-c-format msgid "By default PostGIS will try to detect gettext support and compile with it, however if you run into incompatibility issues that cause breakage of loader, you can disable it entirely with this command. Refer to ticket http://trac.osgeo.org/postgis/ticket/748 for an example issue solved by configuring with this. NOTE: that you aren't missing much by turning this off. This is used for international help/label support for the GUI loader which is not yet documented and still experimental." msgstr "" #. Tag: para -#: installation.xml:503 +#: installation.xml:511 #, no-c-format msgid "By default PostGIS will not install with sfcgal support without this switch. PATH is an optional argument that allows to specify an alternate PATH to sfcgal-config." msgstr "" #. Tag: para -#: installation.xml:511 +#: installation.xml:519 #, no-c-format msgid "If you obtained PostGIS from the SVN repository , the first step is really to run the script" msgstr "" #. Tag: para -#: installation.xml:523 +#: installation.xml:531 #, no-c-format msgid "This script will generate the configure script that in turn is used to customize the installation of PostGIS." msgstr "" #. Tag: para -#: installation.xml:528 +#: installation.xml:536 #, no-c-format msgid "If you instead obtained PostGIS as a tarball, running ./autogen.sh is not necessary as configure has already been generated." msgstr "" #. Tag: title -#: installation.xml:537 +#: installation.xml:545 #, no-c-format msgid "Building" msgstr "" #. Tag: para -#: installation.xml:539 +#: installation.xml:547 #, no-c-format msgid "Once the Makefile has been generated, building PostGIS is as simple as running" msgstr "" #. Tag: para -#: installation.xml:548 +#: installation.xml:556 #, no-c-format msgid "The last line of the output should be \"PostGIS was built successfully. Ready to install.\"" msgstr "" #. Tag: para -#: installation.xml:553 +#: installation.xml:561 #, no-c-format msgid "As of PostGIS v1.4.0, all the functions have comments generated from the documentation. If you wish to install these comments into your spatial databases later, run the command which requires docbook. The postgis_comments.sql and other package comments files raster_comments.sql, topology_comments.sql are also packaged in the tar.gz distribution in the doc folder so no need to make comments if installing from the tar ball." msgstr "" #. Tag: command -#: installation.xml:563 installation.xml:587 +#: installation.xml:571 installation.xml:595 #, no-c-format msgid "make comments" msgstr "" #. Tag: para -#: installation.xml:566 +#: installation.xml:574 #, no-c-format msgid "Introduced in PostGIS 2.0. This generates html cheat sheets suitable for quick reference or for student handouts. This requires xsltproc to build and will generate 4 files in doc folder topology_cheatsheet.html, tiger_geocoder_cheatsheet.html, raster_cheatsheet.html, postgis_cheatsheet.html" msgstr "" #. Tag: para -#: installation.xml:571 +#: installation.xml:579 #, no-c-format msgid "You can download some pre-built ones available in html and pdf from PostGIS / PostgreSQL Study Guides" msgstr "" #. Tag: command -#: installation.xml:574 +#: installation.xml:582 #, no-c-format msgid "make cheatsheets" msgstr "" #. Tag: title -#: installation.xml:579 +#: installation.xml:587 #, no-c-format msgid "Building PostGIS Extensions and Deploying them" msgstr "" #. Tag: para -#: installation.xml:581 +#: installation.xml:589 #, no-c-format msgid "The PostGIS extensions are built and installed automatically if you are using PostgreSQL 9.1+." msgstr "" #. Tag: para -#: installation.xml:584 +#: installation.xml:592 #, no-c-format msgid "If you are building from source repository, you need to build the function descriptions first. These get built if you have docbook installed. You can also manually build with the statement:" msgstr "" #. Tag: para -#: installation.xml:589 +#: installation.xml:597 #, no-c-format msgid "Building the comments is not necessary if you are building from a release tar ball since these are packaged pre-built with the tar ball already." msgstr "" #. Tag: para -#: installation.xml:590 +#: installation.xml:598 #, no-c-format msgid "If you are building against PostgreSQL 9.1, the extensions should automatically build as part of the make install process. You can if needed build from the extensions folders or copy files if you need them on a different server." msgstr "" #. Tag: programlisting -#: installation.xml:592 +#: installation.xml:600 #, no-c-format msgid "" "cd extensions\n" @@ -579,86 +658,116 @@ msgid "" "cd postgis_topology\n" "make clean\n" "make \n" - "make install" + "make install\n" + "cd ..\n" + "cd postgis_sfcgal\n" + "make clean\n" + "make \n" + "make install\n" + "\n" + "cd ..\n" + "cd address_standardizer\n" + "make clean\n" + "make \n" + "make install\n" + "make installcheck\n" + "\n" + "cd ..\n" + "cd postgis_tiger_geocoder\n" + "make clean\n" + "make \n" + "make install\n" + "make installcheck" msgstr "" #. Tag: para -#: installation.xml:593 +#: installation.xml:601 #, no-c-format msgid "The extension files will always be the same for the same version of PostGIS regardless of OS, so it is fine to copy over the extension files from one OS to another as long as you have the PostGIS binaries already installed on your servers." msgstr "" #. Tag: para -#: installation.xml:595 +#: installation.xml:603 #, no-c-format msgid "If you want to install the extensions manually on a separate server different from your development, You need to copy the following files from the extensions folder into the PostgreSQL / share / extension folder of your PostgreSQL install as well as the needed binaries for regular PostGIS if you don't have them already on the server." msgstr "" #. Tag: para -#: installation.xml:602 +#: installation.xml:610 #, no-c-format msgid "These are the control files that denote information such as the version of the extension to install if not specified. postgis.control, postgis_topology.control." msgstr "" #. Tag: para -#: installation.xml:608 +#: installation.xml:616 #, no-c-format msgid "All the files in the /sql folder of each extension. Note that these need to be copied to the root of the PostgreSQL share/extension folder extensions/postgis/sql/*.sql, extensions/postgis_topology/sql/*.sql" msgstr "" #. Tag: para -#: installation.xml:614 +#: installation.xml:622 #, no-c-format msgid "Once you do that, you should see postgis, postgis_topology as available extensions in PgAdmin -> extensions." msgstr "" #. Tag: para -#: installation.xml:615 +#: installation.xml:623 #, no-c-format msgid "If you are using psql, you can verify that the extensions are installed by running this query:" msgstr "" #. Tag: programlisting -#: installation.xml:616 +#: installation.xml:624 #, no-c-format msgid "" "SELECT name, default_version,installed_version \n" - "FROM pg_available_extensions WHERE name LIKE 'postgis%' ;\n" - " name | default_version | installed_version\n" - "-----------------+-----------------+-------------------\n" - "postgis | &last_release_version; | &last_release_version;\n" - "postgis_topology | &last_release_version; |" + "FROM pg_available_extensions WHERE name LIKE 'postgis%' or name LIKE 'address%';\n" + "\n" + " name | default_version | installed_version\n" + "------------------------------+-----------------+-------------------\n" + " address_standardizer | &last_release_version; | &last_release_version; \n" + " address_standardizer_data_us | &last_release_version; | &last_release_version; \n" + " postgis | &last_release_version; | &last_release_version; \n" + " postgis_sfcgal | &last_release_version; |\n" + " postgis_tiger_geocoder | &last_release_version; | &last_release_version; \n" + " postgis_topology | &last_release_version; |\n" + "(6 rows)" msgstr "" #. Tag: para -#: installation.xml:618 +#: installation.xml:626 #, no-c-format msgid "If you have the extension installed in the database you are querying, you'll see mention in the installed_version column. If you get no records back, it means you don't have postgis extensions installed on the server at all. PgAdmin III 1.14+ will also provide this information in the extensions section of the database browser tree and will even allow upgrade or uninstall by right-clicking." msgstr "" #. Tag: para -#: installation.xml:622 +#: installation.xml:630 #, no-c-format msgid "If you have the extensions available, you can install postgis extension in your database of choice by either using pgAdmin extension interface or running these sql commands:" msgstr "" #. Tag: programlisting -#: installation.xml:623 +#: installation.xml:631 #, no-c-format msgid "" "CREATE EXTENSION postgis;\n" - "CREATE EXTENSION postgis_topology;\n" - "CREATE EXTENSION postgis_tiger_geocoder;" + "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" + "CREATE EXTENSION address_standardizer;\n" + "CREATE EXTENSION address_standardizer_data_us;\n" + "CREATE EXTENSION postgis_tiger_geocoder;\n" + "CREATE EXTENSION postgis_topology;" msgstr "" #. Tag: para -#: installation.xml:625 +#: installation.xml:633 #, no-c-format msgid "In psql you can use to see what versions you have installed and also what schema they are installed." msgstr "" #. Tag: programlisting -#: installation.xml:626 +#: installation.xml:634 #, no-c-format msgid "" "\\connect mygisdb\n" @@ -667,7 +776,7 @@ msgid "" msgstr "" #. Tag: screen -#: installation.xml:628 +#: installation.xml:636 #, no-c-format msgid "" "List of installed extensions\n" @@ -692,31 +801,31 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:630 +#: installation.xml:638 #, no-c-format msgid "Extension tables spatial_ref_sys, layer, topology can not be explicitly backed up. They can only be backed up when the respective postgis or postgis_topology extension is backed up, which only seems to happen when you backup the whole database. As of PostGIS 2.0.1, only srid records not packaged with PostGIS are backed up when the database is backed up so don't go around changing srids we package and expect your changes to be there. Put in a ticket if you find an issue. The structures of extension tables are never backed up since they are created with CREATE EXTENSION and assumed to be the same for a given version of an extension. These behaviors are built into the current PostgreSQL extension model, so nothing we can do about it." msgstr "" #. Tag: para -#: installation.xml:635 +#: installation.xml:643 #, no-c-format msgid "If you installed &last_release_version;, without using our wonderful extension system, you can change it to be extension based by first upgrading to the latest micro version running the upgrade scripts: postgis_upgrade_22_minor.sql,raster_upgrade_22_minor.sql,topology_upgrade_22_minor.sql." msgstr "" #. Tag: para -#: installation.xml:636 +#: installation.xml:644 #, no-c-format msgid "If you installed postgis without raster support, you'll need to install raster support first (using the full rtpostgis.sql" msgstr "" #. Tag: para -#: installation.xml:637 +#: installation.xml:645 #, no-c-format msgid "Then you can run the below commands to package the functions in their respective extension." msgstr "" #. Tag: programlisting -#: installation.xml:638 +#: installation.xml:646 #, no-c-format msgid "" "CREATE EXTENSION postgis FROM unpackaged;\n" @@ -725,239 +834,365 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:644 +#: installation.xml:652 #, no-c-format msgid "Testing" msgstr "" #. Tag: para -#: installation.xml:646 +#: installation.xml:654 #, no-c-format msgid "If you wish to test the PostGIS build, run" msgstr "" #. Tag: command -#: installation.xml:651 +#: installation.xml:659 #, no-c-format msgid "make check" msgstr "" #. Tag: para -#: installation.xml:654 +#: installation.xml:662 #, no-c-format msgid "The above command will run through various checks and regression tests using the generated library against an actual PostgreSQL database." msgstr "" #. Tag: para -#: installation.xml:660 +#: installation.xml:668 #, no-c-format msgid "If you configured PostGIS using non-standard PostgreSQL, GEOS, or Proj4 locations, you may need to add their library locations to the LD_LIBRARY_PATH environment variable." msgstr "" #. Tag: para -#: installation.xml:668 +#: installation.xml:676 #, no-c-format msgid "Currently, the make check relies on the PATH and PGPORT environment variables when performing the checks - it does not use the PostgreSQL version that may have been specified using the configuration parameter --with-pgconfig. So make sure to modify your PATH to match the detected PostgreSQL installation during configuration or be prepared to deal with the impending headaches." msgstr "" #. Tag: para -#: installation.xml:680 +#: installation.xml:688 #, no-c-format msgid "If successful, the output of the test should be similar to the following:" msgstr "" #. Tag: programlisting -#: installation.xml:685 +#: installation.xml:693 #, no-c-format msgid "" - "CUnit - A Unit testing framework for C - Version 2.1-0\n" + "CUnit - A unit testing framework for C - Version 2.1-2\n" " http://cunit.sourceforge.net/\n" "\n" "\n" - "Suite: print_suite\n" - " Test: test_lwprint_default_format ... passed\n" - " Test: test_lwprint_format_orders ... passed\n" - " Test: test_lwprint_optional_format ... passed\n" - " Test: test_lwprint_oddball_formats ... passed\n" - " Test: test_lwprint_bad_formats ... passed\n" - "Suite: misc\n" - " Test: test_misc_force_2d ... passed\n" - " Test: test_misc_simplify ... passed\n" - " Test: test_misc_count_vertices ... passed\n" - " Test: test_misc_area ... passed\n" - " Test: test_misc_wkb ... passed\n" - "Suite: ptarray\n" - " Test: test_ptarray_append_point ... passed\n" - " Test: test_ptarray_append_ptarray ... passed\n" - " Test: test_ptarray_locate_point ... passed\n" - " Test: test_ptarray_isccw ... passed\n" - " Test: test_ptarray_signed_area ... passed\n" - " Test: test_ptarray_desegmentize ... passed\n" - " Test: test_ptarray_insert_point ... passed\n" - " Test: test_ptarray_contains_point ... passed\n" - " Test: test_ptarrayarc_contains_point ... passed\n" - "Suite: PostGIS Computational Geometry Suite\n" - " Test: test_lw_segment_side ... passed\n" - " Test: test_lw_segment_intersects ... passed\n" - " Test: test_lwline_crossing_short_lines ... passed\n" - " Test: test_lwline_crossing_long_lines ... passed\n" - " Test: test_lwline_crossing_bugs ... passed\n" - " Test: test_lwpoint_set_ordinate ... passed\n" - " Test: test_lwpoint_get_ordinate ... passed\n" - " Test: test_point_interpolate ... passed\n" - " Test: test_lwline_clip ... passed\n" - " Test: test_lwline_clip_big ... passed\n" - " Test: test_lwmline_clip ... passed\n" - " Test: test_geohash_point ... passed\n" - " Test: test_geohash_precision ... passed\n" - " Test: test_geohash ... passed\n" - " Test: test_geohash_point_as_int ... passed\n" - " Test: test_isclosed ... passed\n" + "Suite: computational_geometry\n" + " Test: test_lw_segment_side ...passed\n" + " Test: test_lw_segment_intersects ...passed\n" + " Test: test_lwline_crossing_short_lines ...passed\n" + " Test: test_lwline_crossing_long_lines ...passed\n" + " Test: test_lwline_crossing_bugs ...passed\n" + " Test: test_lwpoint_set_ordinate ...passed\n" + " Test: test_lwpoint_get_ordinate ...passed\n" + " Test: test_point_interpolate ...passed\n" + " Test: test_lwline_clip ...passed\n" + " Test: test_lwline_clip_big ...passed\n" + " Test: test_lwmline_clip ...passed\n" + " Test: test_geohash_point ...passed\n" + " Test: test_geohash_precision ...passed\n" + " Test: test_geohash ...passed\n" + " Test: test_geohash_point_as_int ...passed\n" + " Test: test_isclosed ...passed\n" + " Test: test_lwgeom_simplify ...passed\n" "Suite: buildarea\n" - " Test: buildarea1 ... passed\n" - " Test: buildarea2 ... passed\n" - " Test: buildarea3 ... passed\n" - " Test: buildarea4 ... passed\n" - " Test: buildarea4b ... passed\n" - " Test: buildarea5 ... passed\n" - " Test: buildarea6 ... passed\n" - " Test: buildarea7 ... passed\n" - "Suite: clean\n" - " Test: test_lwgeom_make_valid ... passed\n" - "Suite: PostGIS Measures Suite\n" - " Test: test_mindistance2d_tolerance ... passed\n" - " Test: test_rect_tree_contains_point ... passed\n" - " Test: test_rect_tree_intersects_tree ... passed\n" - " Test: test_lwgeom_segmentize2d ... passed\n" - " Test: test_lwgeom_locate_along ... passed\n" - " Test: test_lw_dist2d_pt_arc ... passed\n" - " Test: test_lw_dist2d_seg_arc ... passed\n" - " Test: test_lw_dist2d_arc_arc ... passed\n" - " Test: test_lw_arc_length ... passed\n" - " Test: test_lw_dist2d_pt_ptarrayarc ... passed\n" - " Test: test_lw_dist2d_ptarray_ptarrayarc ... passed\n" - "Suite: node\n" - " Test: test_lwgeom_node ... passed\n" - "Suite: WKT Out Suite\n" - " Test: test_wkt_out_point ... passed\n" - " Test: test_wkt_out_linestring ... passed\n" - " Test: test_wkt_out_polygon ... passed\n" - " Test: test_wkt_out_multipoint ... passed\n" - " Test: test_wkt_out_multilinestring ... passed\n" - " Test: test_wkt_out_multipolygon ... passed\n" - " Test: test_wkt_out_collection ... passed\n" - " Test: test_wkt_out_circularstring ... passed\n" - " Test: test_wkt_out_compoundcurve ... passed\n" - " Test: test_wkt_out_curvpolygon ... passed\n" - " Test: test_wkt_out_multicurve ... passed\n" - " Test: test_wkt_out_multisurface ... passed\n" - "Suite: WKT In Suite\n" - " Test: test_wkt_in_point ... passed\n" - " Test: test_wkt_in_linestring ... passed\n" - " Test: test_wkt_in_polygon ... passed\n" - " Test: test_wkt_in_multipoint ... passed\n" - " Test: test_wkt_in_multilinestring ... passed\n" - " Test: test_wkt_in_multipolygon ... passed\n" - " Test: test_wkt_in_collection ... passed\n" - " Test: test_wkt_in_circularstring ... passed\n" - " Test: test_wkt_in_compoundcurve ... passed\n" - " Test: test_wkt_in_curvpolygon ... passed\n" - " Test: test_wkt_in_multicurve ... passed\n" - " Test: test_wkt_in_multisurface ... passed\n" - " Test: test_wkt_in_tin ... passed\n" - " Test: test_wkt_in_polyhedralsurface ... passed\n" - " Test: test_wkt_in_errlocation ... passed\n" - "Suite: WKB Out Suite\n" - " Test: test_wkb_out_point ... passed\n" - " Test: test_wkb_out_linestring ... passed\n" - " Test: test_wkb_out_polygon ... passed\n" - " Test: test_wkb_out_multipoint ... passed\n" - " Test: test_wkb_out_multilinestring ... passed\n" - " Test: test_wkb_out_multipolygon ... passed\n" - " Test: test_wkb_out_collection ... passed\n" - " Test: test_wkb_out_circularstring ... passed\n" - " Test: test_wkb_out_compoundcurve ... passed\n" - " Test: test_wkb_out_curvpolygon ... passed\n" - " Test: test_wkb_out_multicurve ... passed\n" - " Test: test_wkb_out_multisurface ... passed\n" - " Test: test_wkb_out_polyhedralsurface ... passed\n" - ":\n" - "Suite: Geodetic Suite\n" - " 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" - ":\n" - " Test: test_geos_noop ... passed\n" - "Suite: Internal Spatial Trees\n" - " Test: test_tree_circ_create ... passed\n" - " Test: test_tree_circ_pip ... passed\n" - " Test: test_tree_circ_pip2 ... passed\n" - " Test: test_tree_circ_distance ... passed\n" - "Suite: triangulate\n" - " Test: test_lwgeom_delaunay_triangulation ... passed\n" + " Test: buildarea1 ...passed\n" + " Test: buildarea2 ...passed\n" + " Test: buildarea3 ...passed\n" + " Test: buildarea4 ...passed\n" + " Test: buildarea4b ...passed\n" + " Test: buildarea5 ...passed\n" + " Test: buildarea6 ...passed\n" + " Test: buildarea7 ...passed\n" + "Suite: geometry_clean\n" + " Test: test_lwgeom_make_valid ...passed\n" + "Suite: clip_by_rectangle\n" + " Test: test_lwgeom_clip_by_rect ...passed\n" + "Suite: force_sfs\n" + " Test: test_sfs_11 ...passed\n" + " Test: test_sfs_12 ...passed\n" + " Test: test_sqlmm ...passed\n" + "Suite: geodetic\n" + " 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" + " Test: test_edge_intersection ...passed\n" + " Test: test_edge_intersects ...passed\n" + " Test: test_edge_distance_to_point ...passed\n" + " Test: test_edge_distance_to_edge ...passed\n" + " Test: test_lwgeom_distance_sphere ...passed\n" + " Test: test_lwgeom_check_geodetic ...passed\n" + " Test: test_gserialized_from_lwgeom ...passed\n" + " Test: test_spheroid_distance ...passed\n" + " Test: test_spheroid_area ...passed\n" + " Test: test_lwpoly_covers_point2d ...passed\n" + " Test: test_gbox_utils ...passed\n" + " Test: test_vector_angle ...passed\n" + " Test: test_vector_rotate ...passed\n" + " 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_geos_noop ...passed\n" + " Test: test_geos_subdivide ...passed\n" + " Test: test_geos_linemerge ...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: test_unionfind_create ...passed\n" + " Test: test_unionfind_union ...passed\n" + " Test: test_unionfind_ordered_by_cluster ...passed\n" + "Suite: homogenize\n" + " Test: test_coll_point ...passed\n" + " Test: test_coll_line ...passed\n" + " Test: test_coll_poly ...passed\n" + " Test: test_coll_coll ...passed\n" + " Test: test_geom ...passed\n" + " Test: test_coll_curve ...passed\n" + "Suite: encoded_polyline_input\n" + " Test: in_encoded_polyline_test_geoms ...passed\n" + " Test: in_encoded_polyline_test_precision ...passed\n" + "Suite: geojson_input\n" + " Test: in_geojson_test_srid ...passed\n" + " Test: in_geojson_test_bbox ...passed\n" + " Test: in_geojson_test_geoms ...passed\n" + "Suite: twkb_input\n" + " Test: test_twkb_in_point ...passed\n" + " Test: test_twkb_in_linestring ...passed\n" + " Test: test_twkb_in_polygon ...passed\n" + " Test: test_twkb_in_multipoint ...passed\n" + " Test: test_twkb_in_multilinestring ...passed\n" + " Test: test_twkb_in_multipolygon ...passed\n" + " Test: test_twkb_in_collection ...passed\n" + " Test: test_twkb_in_precision ...passed\n" + "Suite: serialization/deserialization\n" + " Test: test_typmod_macros ...passed\n" + " Test: test_flags_macros ...passed\n" + " Test: test_serialized_srid ...passed\n" + " Test: test_gserialized_from_lwgeom_size ...passed\n" + " Test: test_gbox_serialized_size ...passed\n" + " Test: test_lwgeom_from_gserialized ...passed\n" + " Test: test_lwgeom_count_vertices ...passed\n" + " Test: test_on_gser_lwgeom_count_vertices ...passed\n" + " 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_f2d ...passed\n" + " Test: test_lwgeom_clone ...passed\n" + " Test: test_lwgeom_force_clockwise ...passed\n" + " Test: test_lwgeom_calculate_gbox ...passed\n" + " Test: test_lwgeom_is_empty ...passed\n" + " Test: test_lwgeom_same ...passed\n" + " Test: test_lwline_from_lwmpoint ...passed\n" + " Test: test_lwgeom_as_curve ...passed\n" + " Test: test_lwgeom_scale ...passed\n" + " Test: test_gserialized_is_empty ...passed\n" + " Test: test_gbox_same_2d ...passed\n" + "Suite: measures\n" + " Test: test_mindistance2d_tolerance ...passed\n" + " Test: test_rect_tree_contains_point ...passed\n" + " Test: test_rect_tree_intersects_tree ...passed\n" + " Test: test_lwgeom_segmentize2d ...passed\n" + " Test: test_lwgeom_locate_along ...passed\n" + " Test: test_lw_dist2d_pt_arc ...passed\n" + " Test: test_lw_dist2d_seg_arc ...passed\n" + " Test: test_lw_dist2d_arc_arc ...passed\n" + " Test: test_lw_arc_length ...passed\n" + " 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" + "Suite: effectivearea\n" + " Test: do_test_lwgeom_effectivearea_lines ...passed\n" + " Test: do_test_lwgeom_effectivearea_polys ...passed\n" + "Suite: miscellaneous\n" + " Test: test_misc_force_2d ...passed\n" + " Test: test_misc_simplify ...passed\n" + " Test: test_misc_count_vertices ...passed\n" + " Test: test_misc_area ...passed\n" + " Test: test_misc_wkb ...passed\n" + " Test: test_grid ...passed\n" + "Suite: noding\n" + " Test: test_lwgeom_node ...passed\n" + "Suite: encoded_polyline_output\n" + " Test: out_encoded_polyline_test_geoms ...passed\n" + " Test: out_encoded_polyline_test_srid ...passed\n" + " Test: out_encoded_polyline_test_precision ...passed\n" + "Suite: geojson_output\n" + " Test: out_geojson_test_precision ...passed\n" + " Test: out_geojson_test_dims ...passed\n" + " Test: out_geojson_test_srid ...passed\n" + " Test: out_geojson_test_bbox ...passed\n" + " Test: out_geojson_test_geoms ...passed\n" + "Suite: gml_output\n" + " Test: out_gml_test_precision ...passed\n" + " Test: out_gml_test_srid ...passed\n" + " Test: out_gml_test_dims ...passed\n" + " Test: out_gml_test_geodetic ...passed\n" + " Test: out_gml_test_geoms ...passed\n" + " Test: out_gml_test_geoms_prefix ...passed\n" + " Test: out_gml_test_geoms_nodims ...passed\n" + " Test: out_gml2_extent ...passed\n" + " Test: out_gml3_extent ...passed\n" + "Suite: kml_output\n" + " Test: out_kml_test_precision ...passed\n" + " Test: out_kml_test_dims ...passed\n" + " Test: out_kml_test_geoms ...passed\n" + " Test: out_kml_test_prefix ...passed\n" + "Suite: svg_output\n" + " Test: out_svg_test_precision ...passed\n" + " Test: out_svg_test_dims ...passed\n" + " Test: out_svg_test_relative ...passed\n" + " Test: out_svg_test_geoms ...passed\n" + " Test: out_svg_test_srid ...passed\n" + "Suite: x3d_output\n" + " Test: out_x3d3_test_precision ...passed\n" + " Test: out_x3d3_test_geoms ...passed\n" + " Test: out_x3d3_test_option ...passed\n" + "Suite: ptarray\n" + " Test: test_ptarray_append_point ...passed\n" + " Test: test_ptarray_append_ptarray ...passed\n" + " 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" + " Test: test_ptarray_scale ...passed\n" + "Suite: printing\n" + " Test: test_lwprint_default_format ...passed\n" + " Test: test_lwprint_format_orders ...passed\n" + " Test: test_lwprint_optional_format ...passed\n" + " Test: test_lwprint_oddball_formats ...passed\n" + " Test: test_lwprint_bad_formats ...passed\n" + "Suite: SFCGAL\n" + " Test: test_sfcgal_noop ...passed\n" + "Suite: split\n" + " Test: test_lwline_split_by_point_to ...passed\n" + " Test: test_lwgeom_split ...passed\n" "Suite: stringbuffer\n" - " Test: test_stringbuffer_append ... passed\n" - " Test: test_stringbuffer_aprintf ... passed\n" + " Test: test_stringbuffer_append ...passed\n" + " Test: test_stringbuffer_aprintf ...passed\n" "Suite: surface\n" - " Test: triangle_parse ... passed\n" - " Test: tin_parse ... passed\n" - " Test: polyhedralsurface_parse ... passed\n" - " Test: surface_dimension ... passed\n" - "Suite: homogenize\n" - " Test: test_coll_point ... passed\n" - " Test: test_coll_line ... passed\n" - " Test: test_coll_poly ... passed\n" - " Test: test_coll_coll ... passed\n" - " Test: test_geom ... passed\n" - " Test: test_coll_curve ... passed\n" - "Suite: force_sfs\n" - " Test: test_sfs_11 ... passed\n" - " Test: test_sfs_12 ... passed\n" - " Test: test_sqlmm ... passed\n" - "Suite: out_gml\n" - " Test: out_gml_test_precision ... passed\n" - " Test: out_gml_test_srid ... passed\n" - " Test: out_gml_test_dims ... passed\n" - " Test: out_gml_test_geodetic ... passed\n" - " Test: out_gml_test_geoms ... passed\n" - " Test: out_gml_test_geoms_prefix ... passed\n" - " Test: out_gml_test_geoms_nodims ... passed\n" - " Test: out_gml2_extent ... passed\n" - " Test: out_gml3_extent ... passed\n" - "Suite: KML Out Suite\n" - " Test: out_kml_test_precision ... passed\n" - " Test: out_kml_test_dims ... passed\n" - " Test: out_kml_test_geoms ... passed\n" - " Test: out_kml_test_prefix ... passed\n" - "Suite: GeoJson Out Suite\n" - " Test: out_geojson_test_precision ... passed\n" - " Test: out_geojson_test_dims ... passed\n" - " Test: out_geojson_test_srid ... passed\n" - " Test: out_geojson_test_bbox ... passed\n" - " Test: out_geojson_test_geoms ... passed\n" - "Suite: SVG Out Suite\n" - " Test: out_svg_test_precision ... passed\n" - " Test: out_svg_test_dims ... passed\n" - " Test: out_svg_test_relative ... passed\n" - " Test: out_svg_test_geoms ... passed\n" - " Test: out_svg_test_srid ... passed\n" - "Suite: X3D Out Suite\n" - " Test: out_x3d3_test_precision ... passed\n" - " Test: out_x3d3_test_geoms ... passed\n" + " Test: triangle_parse ...passed\n" + " Test: tin_parse ...passed\n" + " Test: polyhedralsurface_parse ...passed\n" + " Test: surface_dimension ...passed\n" + "Suite: Internal Spatial Trees\n" + " Test: test_tree_circ_create ...passed\n" + " Test: test_tree_circ_pip ...passed\n" + " Test: test_tree_circ_pip2 ...passed\n" + " Test: test_tree_circ_distance ...passed\n" + " Test: test_tree_circ_distance_threshold ...passed\n" + "Suite: triangulate\n" + " Test: test_lwgeom_delaunay_triangulation ...passed\n" + "Suite: twkb_output\n" + " Test: test_twkb_out_point ...passed\n" + " Test: test_twkb_out_linestring ...passed\n" + " Test: test_twkb_out_polygon ...passed\n" + " Test: test_twkb_out_multipoint ...passed\n" + " Test: test_twkb_out_multilinestring ...passed\n" + " Test: test_twkb_out_multipolygon ...passed\n" + " Test: test_twkb_out_collection ...passed\n" + " Test: test_twkb_out_idlist ...passed\n" + "Suite: varint\n" + " Test: test_zigzag ...passed\n" + " Test: test_varint ...passed\n" + " Test: test_varint_roundtrip ...passed\n" + "Suite: wkb_input\n" + " Test: test_wkb_in_point ...passed\n" + " Test: test_wkb_in_linestring ...passed\n" + " Test: test_wkb_in_polygon ...passed\n" + " Test: test_wkb_in_multipoint ...passed\n" + " Test: test_wkb_in_multilinestring ...passed\n" + " Test: test_wkb_in_multipolygon ...passed\n" + " Test: test_wkb_in_collection ...passed\n" + " Test: test_wkb_in_circularstring ...passed\n" + " Test: test_wkb_in_compoundcurve ...passed\n" + " Test: test_wkb_in_curvpolygon ...passed\n" + " Test: test_wkb_in_multicurve ...passed\n" + " Test: test_wkb_in_multisurface ...passed\n" + " Test: test_wkb_in_malformed ...passed\n" + "Suite: wkb_output\n" + " Test: test_wkb_out_point ...passed\n" + " Test: test_wkb_out_linestring ...passed\n" + " Test: test_wkb_out_polygon ...passed\n" + " Test: test_wkb_out_multipoint ...passed\n" + " Test: test_wkb_out_multilinestring ...passed\n" + " Test: test_wkb_out_multipolygon ...passed\n" + " Test: test_wkb_out_collection ...passed\n" + " Test: test_wkb_out_circularstring ...passed\n" + " Test: test_wkb_out_compoundcurve ...passed\n" + " Test: test_wkb_out_curvpolygon ...passed\n" + " Test: test_wkb_out_multicurve ...passed\n" + " Test: test_wkb_out_multisurface ...passed\n" + " Test: test_wkb_out_polyhedralsurface ...passed\n" + "Suite: wkt_input\n" + " Test: test_wkt_in_point ...passed\n" + " Test: test_wkt_in_linestring ...passed\n" + " Test: test_wkt_in_polygon ...passed\n" + " Test: test_wkt_in_multipoint ...passed\n" + " Test: test_wkt_in_multilinestring ...passed\n" + " Test: test_wkt_in_multipolygon ...passed\n" + " Test: test_wkt_in_collection ...passed\n" + " Test: test_wkt_in_circularstring ...passed\n" + " Test: test_wkt_in_compoundcurve ...passed\n" + " Test: test_wkt_in_curvpolygon ...passed\n" + " Test: test_wkt_in_multicurve ...passed\n" + " Test: test_wkt_in_multisurface ...passed\n" + " Test: test_wkt_in_tin ...passed\n" + " Test: test_wkt_in_polyhedralsurface ...passed\n" + " Test: test_wkt_in_errlocation ...passed\n" + "Suite: wkt_output\n" + " Test: test_wkt_out_point ...passed\n" + " Test: test_wkt_out_linestring ...passed\n" + " Test: test_wkt_out_polygon ...passed\n" + " Test: test_wkt_out_multipoint ...passed\n" + " Test: test_wkt_out_multilinestring ...passed\n" + " Test: test_wkt_out_multipolygon ...passed\n" + " Test: test_wkt_out_collection ...passed\n" + " Test: test_wkt_out_circularstring ...passed\n" + " Test: test_wkt_out_compoundcurve ...passed\n" + " Test: test_wkt_out_curvpolygon ...passed\n" + " Test: test_wkt_out_multicurve ...passed\n" + " Test: test_wkt_out_multisurface ...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" "\n" - "--Run Summary: Type Total Ran Passed Failed\n" - " suites 27 27 n/a 0\n" - " tests 198 198 198 0\n" - " asserts 1728 1728 1728 0\n" + "Elapsed time = 0.298 seconds\n" "\n" "Creating database 'postgis_reg' \n" "Loading PostGIS into 'postgis_reg' \n" - "PostgreSQL 9.3beta1 on x86_64-unknown-linux-gnu, compiled by gcc (Debian 4.4.5-8) 4.4.5, 64-bit\n" - " Postgis 2.1.0SVN - r11415 - 2013-05-11 02:48:21\n" - " GEOS: 3.4.0dev-CAPI-1.8.0 r3797\n" - " PROJ: Rel. 4.7.1, 23 September 2009\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" "\n" "Running tests\n" "\n" @@ -983,24 +1218,57 @@ msgid "" " 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" + " cluster .. ok \n" + " concave_hull .. ok \n" + " ctors .. ok \n" + " dump .. ok \n" + " dumppoints .. ok \n" + " empty .. ok \n" + " forcecurve .. ok \n" + " geography .. ok \n" + " in_geohash .. ok \n" + " in_gml .. ok \n" + " in_kml .. ok \n" + " in_encodedpolyline .. ok \n" + " iscollection .. ok \n" + " legacy .. ok \n" + " long_xact .. ok \n" + " lwgeom_regress .. ok \n" + " measures .. ok \n" + " operators .. ok \n" + " out_geometry .. ok \n" + " out_geography .. ok \n" + " polygonize .. ok \n" + " polyhedralsurface .. ok \n" + " postgis_type_name .. ok \n" " regress .. ok \n" + " regress_bdpoly .. ok \n" " regress_index .. ok \n" " regress_index_nulls .. ok \n" + " regress_management .. ok \n" " regress_selectivity .. ok \n" - " lwgeom_regress .. ok \n" " regress_lrs .. ok \n" + " regress_ogc .. ok \n" + " regress_ogc_cover .. ok \n" + " regress_ogc_prep .. ok \n" + " regress_proj .. ok \n" + " relate .. ok \n" + " remove_repeated_points .. ok \n" " removepoint .. ok \n" " setpoint .. ok \n" " simplify .. ok \n" + " simplifyvw .. ok \n" + " size .. ok \n" " snaptogrid .. ok \n" - " summary .. ok \n" - " affine .. ok \n" - " empty .. ok \n" - " measures .. ok \n" - " legacy .. ok \n" - " long_xact .. ok \n" - " ctors .. ok \n" + " split .. ok \n" " sql-mm-serialize .. ok \n" " sql-mm-circularstring .. ok \n" " sql-mm-compoundcurve .. ok \n" @@ -1008,35 +1276,16 @@ msgid "" " sql-mm-general .. ok \n" " sql-mm-multicurve .. ok \n" " sql-mm-multisurface .. ok \n" - " polyhedralsurface .. ok \n" - " polygonize .. ok \n" - " postgis_type_name .. ok \n" - " geography .. ok \n" - " out_geometry .. ok \n" - " out_geography .. ok \n" - " in_geohash .. ok \n" - " in_gml .. ok \n" - " in_kml .. ok \n" - " iscollection .. ok \n" - " regress_ogc .. ok \n" - " regress_ogc_cover .. ok \n" - " regress_ogc_prep .. ok \n" - " regress_bdpoly .. ok \n" - " regress_proj .. ok \n" - " regress_management .. ok \n" - " dump .. ok \n" - " dumppoints .. ok \n" - " boundary .. ok \n" - " wmsservers .. ok \n" - " wkt .. ok \n" - " wkb .. ok \n" + " swapordinates .. ok \n" + " summary .. ok \n" + " temporal .. ok \n" " tickets .. ok \n" + " twkb .. ok \n" " typmod .. ok \n" - " remove_repeated_points .. ok \n" - " split .. ok \n" - " relate .. ok \n" - " bestsrid .. ok \n" - " concave_hull .. ok \n" + " wkb .. ok \n" + " wkt .. ok \n" + " wmsservers .. ok \n" + " knn .. ok \n" " hausdorff .. ok \n" " regress_buffer_params .. ok \n" " offsetcurve .. ok \n" @@ -1049,296 +1298,425 @@ msgid "" " clean .. ok \n" " relate_bnr .. ok \n" " delaunaytriangles .. ok \n" + " clipbybox2d .. ok \n" + " subdivide .. ok \n" " in_geojson .. ok \n" - " uninstall .. ok (4112)\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" + "\n" + "Run tests: 118\n" + "Failed: 0\n" + "\n" + "-- if you built --with-gui, you should see this too\n" + "\n" + " CUnit - A unit testing framework for C - Version 2.1-2\n" + " http://cunit.sourceforge.net/\n" + "\n" + "\n" + "Suite: Shapefile Loader File shp2pgsql Test\n" + " Test: test_ShpLoaderCreate() ...passed\n" + " Test: test_ShpLoaderDestroy() ...passed\n" + "Suite: Shapefile Loader File pgsql2shp Test\n" + " Test: test_ShpDumperCreate() ...passed\n" + " Test: test_ShpDumperDestroy() ...passed\n" + "\n" + "Run Summary: Type Total Ran Passed Failed Inactive\n" + " suites 2 2 n/a 0 0\n" + " tests 4 4 4 0 0\n" + " asserts 4 4 4 0 n/a" +msgstr "" + +#. Tag: para +#: installation.xml:695 +#, no-c-format +msgid "The postgis_tiger_geocoder and address_standardizer extensions, currenlty only support the standard PostgreSQL installcheck. To test these use the below. Note: the make install is not necessary if you already did make install at root of PostGIS code folder." +msgstr "" + +#. Tag: para +#: installation.xml:696 +#, no-c-format +msgid "For address_standardizer:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:697 +#, no-c-format +msgid "" + "cd extensions/address_standardizer\n" + "make install\n" + "make installcheck" +msgstr "" + +#. Tag: para +#: installation.xml:699 +#, no-c-format +msgid "Output should look like:" +msgstr "" + +#. Tag: screen +#: installation.xml:700 +#, no-c-format +msgid "" + "============== dropping database \"contrib_regression\" ==============\n" + "DROP DATABASE\n" + "============== creating database \"contrib_regression\" ==============\n" + "CREATE DATABASE\n" + "ALTER DATABASE\n" + "============== running regression test queries ==============\n" + "test test-init-extensions ... ok\n" + "test test-parseaddress ... ok\n" + "test test-standardize_address_1 ... ok\n" + "test test-standardize_address_2 ... ok\n" + "\n" + "=====================\n" + " All 4 tests passed.\n" + "=====================" +msgstr "" + +#. Tag: para +#: installation.xml:702 +#, no-c-format +msgid "For tiger geocoder, make sure you have postgis and fuzzystrmatch extensions available in your PostgreSQL instance. The address_standardizer tests will also kick in if you built postgis with address_standardizer support:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:703 +#, no-c-format +msgid "" + "cd extensions/postgis_tiger_geocoder\n" + "make install\n" + "make installcheck" +msgstr "" + +#. Tag: para +#: installation.xml:704 +#, no-c-format +msgid "output should look like:" +msgstr "" + +#. Tag: screen +#: installation.xml:705 +#, no-c-format +msgid "" + "============== dropping database \"contrib_regression\" ==============\n" + "DROP DATABASE\n" + "============== creating database \"contrib_regression\" ==============\n" + "CREATE DATABASE\n" + "ALTER DATABASE\n" + "============== installing fuzzystrmatch ==============\n" + "CREATE EXTENSION\n" + "============== installing postgis ==============\n" + "CREATE EXTENSION\n" + "============== installing postgis_tiger_geocoder ==============\n" + "CREATE EXTENSION\n" + "============== installing address_standardizer ==============\n" + "CREATE EXTENSION\n" + "============== running regression test queries ==============\n" + "test test-normalize_address ... ok\n" + "test test-pagc_normalize_address ... ok\n" "\n" - "Run tests: 90" + "=====================\n" + "All 2 tests passed.\n" + "=====================" msgstr "" #. Tag: title -#: installation.xml:689 +#: installation.xml:709 #, no-c-format msgid "Installation" msgstr "" #. Tag: para -#: installation.xml:691 +#: installation.xml:711 #, no-c-format msgid "To install PostGIS, type" msgstr "" #. Tag: command -#: installation.xml:696 +#: installation.xml:716 #, no-c-format msgid "make install" msgstr "" #. Tag: para -#: installation.xml:699 +#: installation.xml:719 #, no-c-format msgid "This will copy the PostGIS installation files into their appropriate subdirectory specified by the --prefix configuration parameter. In particular:" msgstr "" #. Tag: para -#: installation.xml:707 +#: installation.xml:727 #, no-c-format msgid "The loader and dumper binaries are installed in [prefix]/bin." msgstr "" #. Tag: para -#: installation.xml:714 +#: installation.xml:734 #, no-c-format msgid "The SQL files, such as postgis.sql, are installed in [prefix]/share/contrib." msgstr "" #. Tag: para -#: installation.xml:721 +#: installation.xml:741 #, no-c-format msgid "The PostGIS libraries are installed in [prefix]/lib." msgstr "" #. Tag: para -#: installation.xml:728 +#: installation.xml:748 #, no-c-format msgid "If you previously ran the make comments command to generate the postgis_comments.sql, raster_comments.sql file, install the sql file by running" msgstr "" #. Tag: command -#: installation.xml:735 +#: installation.xml:755 #, no-c-format msgid "make comments-install" msgstr "" #. Tag: para -#: installation.xml:739 +#: installation.xml:759 #, no-c-format msgid "postgis_comments.sql, raster_comments.sql, topology_comments.sql was separated from the typical build and installation targets since with it comes the extra dependency of xsltproc." msgstr "" #. Tag: title -#: installation.xml:749 +#: installation.xml:769 #, no-c-format msgid "Create a spatially-enabled database on PostgreSQL lower than 9.1" msgstr "" #. Tag: para -#: installation.xml:751 +#: installation.xml:771 #, no-c-format msgid "The first step in creating a PostGIS database is to create a simple PostgreSQL database." msgstr "" #. Tag: command -#: installation.xml:757 installation.xml:854 +#: installation.xml:777 installation.xml:874 #, no-c-format msgid "createdb [yourdatabase]" msgstr "" #. Tag: para -#: installation.xml:760 +#: installation.xml:780 #, no-c-format msgid "Many of the PostGIS functions are written in the PL/pgSQL procedural language. As such, the next step to create a PostGIS database is to enable the PL/pgSQL language in your new database. This is accomplish by the command below command. For PostgreSQL 8.4+, this is generally already installed" msgstr "" #. Tag: command -#: installation.xml:768 +#: installation.xml:788 #, no-c-format msgid "createlang plpgsql [yourdatabase]" msgstr "" #. Tag: para -#: installation.xml:771 +#: installation.xml:791 #, no-c-format msgid "Now load the PostGIS object and function definitions into your database by loading the postgis.sql definitions file (located in [prefix]/share/contrib as specified during the configuration step)." msgstr "" #. Tag: command -#: installation.xml:779 +#: installation.xml:799 #, no-c-format msgid "psql -d [yourdatabase] -f postgis.sql" msgstr "" #. Tag: para -#: installation.xml:782 +#: installation.xml:802 #, no-c-format msgid "For a complete set of EPSG coordinate system definition identifiers, you can also load the spatial_ref_sys.sql definitions file and populate the spatial_ref_sys table. This will permit you to perform ST_Transform() operations on geometries." msgstr "" #. Tag: command -#: installation.xml:790 +#: installation.xml:810 #, no-c-format msgid "psql -d [yourdatabase] -f spatial_ref_sys.sql" msgstr "" #. Tag: para -#: installation.xml:793 +#: installation.xml:813 #, no-c-format msgid "If you wish to add comments to the PostGIS functions, the final step is to load the postgis_comments.sql into your spatial database. The comments can be viewed by simply typing \\dd [function_name] from a psql terminal window." msgstr "" #. Tag: command -#: installation.xml:801 +#: installation.xml:821 #, no-c-format msgid "psql -d [yourdatabase] -f postgis_comments.sql" msgstr "" #. Tag: para -#: installation.xml:804 +#: installation.xml:824 #, no-c-format msgid "Install raster support" msgstr "" #. Tag: command -#: installation.xml:809 +#: installation.xml:829 #, no-c-format msgid "psql -d [yourdatabase] -f rtpostgis.sql" msgstr "" #. Tag: para -#: installation.xml:812 +#: installation.xml:832 #, no-c-format msgid "Install raster support comments. This will provide quick help info for each raster function using psql or PgAdmin or any other PostgreSQL tool that can show function comments" msgstr "" #. Tag: command -#: installation.xml:818 +#: installation.xml:838 #, no-c-format msgid "psql -d [yourdatabase] -f raster_comments.sql" msgstr "" #. Tag: para -#: installation.xml:820 +#: installation.xml:840 #, no-c-format msgid "Install topology support" msgstr "" #. Tag: command -#: installation.xml:825 +#: installation.xml:845 #, no-c-format msgid "psql -d [yourdatabase] -f topology/topology.sql" msgstr "" #. Tag: para -#: installation.xml:828 +#: installation.xml:848 #, no-c-format msgid "Install topology support comments. This will provide quick help info for each topology function / type using psql or PgAdmin or any other PostgreSQL tool that can show function comments" msgstr "" #. Tag: command -#: installation.xml:834 +#: installation.xml:854 #, no-c-format msgid "psql -d [yourdatabase] -f topology/topology_comments.sql" msgstr "" #. Tag: para -#: installation.xml:837 installation.xml:874 +#: installation.xml:857 installation.xml:894 #, no-c-format msgid "If you plan to restore an old backup from prior versions in this new db, run:" msgstr "" #. Tag: command -#: installation.xml:838 installation.xml:875 +#: installation.xml:858 installation.xml:895 #, no-c-format msgid "psql -d [yourdatabase] -f legacy.sql" msgstr "" #. Tag: para -#: installation.xml:839 +#: installation.xml:859 #, no-c-format msgid "There is an alternative legacy_minimal.sql you can run instead which will install barebones needed to recover tables and work with apps like MapServer and GeoServer. If you have views that use things like distance / length etc, you'll need the full blown legacy.sql" msgstr "" #. Tag: para -#: installation.xml:842 installation.xml:877 +#: installation.xml:862 installation.xml:897 #, no-c-format msgid "You can later run uninstall_legacy.sql to get rid of the deprecated functions after you are done with restoring and cleanup." msgstr "" #. Tag: title -#: installation.xml:846 +#: installation.xml:866 #, no-c-format msgid "Creating a spatial database using EXTENSIONS" msgstr "" #. Tag: para -#: installation.xml:848 +#: installation.xml:868 #, no-c-format msgid "If you are using PostgreSQL 9.1+ and have compiled and installed the extensions/ postgis modules, you can create a spatial database the new way." msgstr "" #. Tag: para -#: installation.xml:857 +#: installation.xml:877 #, no-c-format msgid "The core postgis extension installs PostGIS geometry, geography, raster, spatial_ref_sys and all the functions and comments with a simple: CREATE EXTENSION postgis; command." msgstr "" #. Tag: command -#: installation.xml:863 +#: installation.xml:883 #, no-c-format msgid "psql -d [yourdatabase] -c \"CREATE EXTENSION postgis;\"" msgstr "" #. Tag: para -#: installation.xml:866 +#: installation.xml:886 #, no-c-format msgid "Topology is packaged as a separate extension and installable with command:" msgstr "" #. Tag: command -#: installation.xml:871 +#: installation.xml:891 #, no-c-format msgid "psql -d [yourdatabase] -c \"CREATE EXTENSION postgis_topology;\"" msgstr "" #. Tag: title -#: installation.xml:880 +#: installation.xml:900 #, no-c-format msgid "Installing and Using the address standardizer" msgstr "" #. Tag: para -#: installation.xml:881 +#: installation.xml:901 #, no-c-format msgid "The address_standardizer extension used to be a separate package that required separate download. From PostGIS 2.2 on, it is now bundled in. For more information about the address_standardize, what it does, and how to configure it for your needs, refer to ." msgstr "" #. Tag: para -#: installation.xml:883 +#: installation.xml:903 #, no-c-format msgid "This standardizer can be used in conjunction with the PostGIS packaged tiger geocoder extension as a replacement for the discussed. To use as replacement refer to . You can also use it as a building block for your own geocoder or use it to standardize your addresses for easier compare of addresses." msgstr "" #. Tag: para -#: installation.xml:887 +#: installation.xml:907 #, no-c-format msgid "The address standardizer relies on PCRE which is usually already installed on many Nix systems, but you can download the latest at: http://www.pcre.org. If during , PCRE is found, then the address standardizer extension will automatically be built. If you have a custom pcre install you want to use instead, pass to configure --with-pcredir=/path/to/pcre where /path/to/pcre is the root folder for your pcre include and lib directories." msgstr "" #. Tag: para -#: installation.xml:890 +#: installation.xml:910 #, no-c-format msgid "For Windows users, the PostGIS 2.1+ bundle is packaged with the address_standardizer already so no need to compile and can move straight to CREATE EXTENSION step." msgstr "" #. Tag: para -#: installation.xml:893 +#: installation.xml:913 #, no-c-format msgid "Once you have installed, you can connect to your database and run the SQL:" msgstr "" #. Tag: programlisting -#: installation.xml:894 +#: installation.xml:914 #, no-c-format msgid "CREATE EXTENSION address_standardizer;" msgstr "" #. Tag: para -#: installation.xml:896 +#: installation.xml:916 #, no-c-format msgid "The following test requires no rules, gaz, or lex tables" msgstr "" #. Tag: programlisting -#: installation.xml:897 +#: installation.xml:917 #, no-c-format msgid "" "SELECT num, street, city, state, zip \n" @@ -1346,13 +1724,13 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:898 +#: installation.xml:918 #, no-c-format msgid "Output should be" msgstr "" #. Tag: screen -#: installation.xml:899 +#: installation.xml:919 #, no-c-format msgid "" "num | street | city | state | zip\n" @@ -1361,79 +1739,79 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:901 +#: installation.xml:921 #, no-c-format msgid "Installing Regex::Assemble" msgstr "" #. Tag: para -#: installation.xml:902 +#: installation.xml:922 #, no-c-format msgid "Perl Regex:Assemble is no longer needed for compiling address_standardizer extension since the files it generates are part of the source tree. However if you need to edit the usps-st-city-orig.txt or usps-st-city-orig.txt usps-st-city-adds.tx, you need to rebuild parseaddress-stcities.h which does require Regex:Assemble." msgstr "" #. Tag: programlisting -#: installation.xml:903 +#: installation.xml:923 #, no-c-format msgid "cpan Regexp::Assemble" msgstr "" #. Tag: para -#: installation.xml:904 +#: installation.xml:924 #, no-c-format msgid "or if you are on Ubuntu / Debian you might need to do" msgstr "" #. Tag: programlisting -#: installation.xml:905 +#: installation.xml:925 #, no-c-format msgid "sudo perl -MCPAN -e \"install Regexp::Assemble\"" msgstr "" #. Tag: title -#: installation.xml:910 +#: installation.xml:930 #, no-c-format msgid "Installing, Upgrading Tiger Geocoder and loading data" msgstr "" #. Tag: para -#: installation.xml:912 +#: installation.xml:932 #, no-c-format -msgid "Extras like Tiger geocoder may not be packaged in your PostGIS distribution, but will always be available in the postgis-&last_release_version;.tar.gz file. The instructions provided here are also available in the extras/tiger_geocoder/tiger_2011/README" +msgid "Extras like Tiger geocoder may not be packaged in your PostGIS distribution, but will always be available in the postgis-&last_release_version;.tar.gz file. The instructions provided here are also available in the extras/tiger_geocoder/README" msgstr "" #. Tag: para -#: installation.xml:913 +#: installation.xml:933 #, no-c-format msgid "If you are on Windows and you don't have tar installed, you can use http://www.7-zip.org/ to unzip the PostGIS tarball." msgstr "" #. Tag: title -#: installation.xml:915 +#: installation.xml:935 #, no-c-format msgid "Tiger Geocoder Enabling your PostGIS database: Using Extension" msgstr "" #. Tag: para -#: installation.xml:916 +#: installation.xml:936 #, no-c-format -msgid "If you are using PostgreSQL 9.1+ and PostGIS 2.1.0, you can take advantage of the new extension model for installing tiger geocoder. To do so:" +msgid "If you are using PostgreSQL 9.1+ and PostGIS 2.1+, you can take advantage of the new extension model for installing tiger geocoder. To do so:" msgstr "" #. Tag: para -#: installation.xml:918 +#: installation.xml:938 #, no-c-format -msgid "First get binaries for PostGIS 2.1.0 or compile and install as usual. This should install the necessary extension files as well for tiger geocoder." +msgid "First get binaries for PostGIS 2.1+ or compile and install as usual. This should install the necessary extension files as well for tiger geocoder." msgstr "" #. Tag: para -#: installation.xml:919 +#: installation.xml:939 #, no-c-format msgid "Connect to your database via psql or pgAdmin or some other tool and run the following SQL commands. Note that if you are installing in a database that already has postgis, you don't need to do the first step. If you have fuzzystrmatch extension already installed, you don't need to do the second step either." msgstr "" #. Tag: programlisting -#: installation.xml:920 +#: installation.xml:940 #, no-c-format msgid "" "CREATE EXTENSION postgis; \n" @@ -1442,13 +1820,13 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:921 +#: installation.xml:941 #, no-c-format msgid "To confirm your install is working correctly, run this sql in your database:" msgstr "" #. Tag: programlisting -#: installation.xml:922 +#: installation.xml:942 #, no-c-format msgid "" "SELECT na.address, na.streetname,na.streettypeabbrev, na.zip\n" @@ -1456,13 +1834,13 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:923 +#: installation.xml:943 #, no-c-format msgid "Which should output" msgstr "" #. Tag: screen -#: installation.xml:924 +#: installation.xml:944 #, no-c-format msgid "" "address | streetname | streettypeabbrev | zip\n" @@ -1471,19 +1849,19 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:926 +#: installation.xml:946 #, no-c-format msgid "Create a new record in tiger.loader_platform table with the paths of your executables and server." msgstr "" #. Tag: para -#: installation.xml:927 +#: installation.xml:947 #, no-c-format msgid "So for example to create a profile called debbie that follows sh convention. You would do:" msgstr "" #. Tag: programlisting -#: installation.xml:928 +#: installation.xml:948 #, no-c-format msgid "" "INSERT INTO tiger.loader_platform(os, declare_sect, pgbin, wget, unzip_command, psql, path_sep, \n" @@ -1495,121 +1873,154 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:929 +#: installation.xml:949 #, no-c-format msgid "And then edit the paths in the declare_sect column to those that fit Debbie's pg, unzip,shp2pgsql, psql, etc path locations." msgstr "" #. Tag: para -#: installation.xml:931 +#: installation.xml:951 #, no-c-format msgid "If you don't edit this loader_platform table, it will just contain common case locations of items and you'll have to edit the generated script after the script is generated." msgstr "" #. Tag: para -#: installation.xml:933 +#: installation.xml:953 #, no-c-format -msgid "Then run the and SQL functions make sure to use the name of your custom profile. So for example to do the nation load using our new profile we would:" +msgid "Then run the and SQL functions make sure to use the name of your custom profile and copy the scripts to a .sh or .bat file. So for example to do the nation load and one state using our new profile we would:" msgstr "" #. Tag: programlisting -#: installation.xml:934 +#: installation.xml:954 #, no-c-format msgid "SELECT Loader_Generate_Nation_Script('debbie');" msgstr "" +#. Tag: programlisting +#: installation.xml:955 +#, no-c-format +msgid "SELECT Loader_Generate_Script(ARRAY['MA'], 'debbie');" +msgstr "" + +#. Tag: para +#: installation.xml:957 +#, no-c-format +msgid "Run the generated scripts." +msgstr "" + +#. Tag: para +#: installation.xml:958 +#, no-c-format +msgid "After you are done loading all data or at a stopping point, it's a good idea to analyze all the tiger tables to update the stats (include inherited stats)" +msgstr "" + +#. Tag: programlisting +#: installation.xml:959 +#, no-c-format +msgid "" + "SELECT install_missing_indexes();\n" + "vacuum analyze verbose tiger.addr;\n" + "vacuum analyze verbose tiger.edges;\n" + "vacuum analyze verbose tiger.faces;\n" + "vacuum analyze verbose tiger.featnames;\n" + "vacuum analyze verbose tiger.place;\n" + "vacuum analyze verbose tiger.cousub;\n" + "vacuum analyze verbose tiger.county;\n" + "vacuum analyze verbose tiger.state;" +msgstr "" + #. Tag: title -#: installation.xml:937 +#: installation.xml:962 #, no-c-format msgid "Converting a Tiger Geocoder Regular Install to Extension Model" msgstr "" #. Tag: para -#: installation.xml:938 +#: installation.xml:963 #, no-c-format msgid "If you installed the tiger geocoder without using the extension model, you can convert to the extension model as follows:" msgstr "" #. Tag: para -#: installation.xml:940 +#: installation.xml:965 #, no-c-format msgid "Follow instructions in for the non-extension model upgrade." msgstr "" #. Tag: para -#: installation.xml:941 +#: installation.xml:966 #, no-c-format msgid "Connect to your database with psql or pgAdmin and run the following command:" msgstr "" #. Tag: programlisting -#: installation.xml:942 +#: installation.xml:967 #, no-c-format msgid "CREATE EXTENSION postgis_tiger_geocoder FROM unpackaged;" msgstr "" #. Tag: title -#: installation.xml:949 +#: installation.xml:974 #, no-c-format msgid "Tiger Geocoder Enabling your PostGIS database: Not Using Extensions" msgstr "" #. Tag: para -#: installation.xml:950 +#: installation.xml:975 #, no-c-format msgid "First install PostGIS using the prior instructions." msgstr "" #. Tag: para -#: installation.xml:954 installation.xml:1014 +#: installation.xml:979 installation.xml:1039 #, no-c-format msgid "If you don't have an extras folder, download &postgis_download_url;" msgstr "" #. Tag: command -#: installation.xml:959 installation.xml:1019 +#: installation.xml:984 installation.xml:1044 #, no-c-format msgid "tar xvfz postgis-&last_release_version;.tar.gz" msgstr "" #. Tag: command -#: installation.xml:963 installation.xml:1023 +#: installation.xml:988 #, no-c-format -msgid "cd postgis-&last_release_version;/extras/tiger_geocoder/tiger_2011" +msgid "cd postgis-&last_release_version;/extras/tiger_geocoder" msgstr "" #. Tag: para -#: installation.xml:966 +#: installation.xml:991 #, no-c-format -msgid "Edit the tiger_loader_2012.sql to the paths of your executables server etc or alternatively you can update the loader_platform table once installed. If you don't edit this file or the loader_platform table, it will just contain common case locations of items and you'll have to edit the generated script after the fact when you run the and SQL functions." +msgid "Edit the tiger_loader_2015.sql (or latest loader file you find, unless you want to load different year) to the paths of your executables server etc or alternatively you can update the loader_platform table once installed. If you don't edit this file or the loader_platform table, it will just contain common case locations of items and you'll have to edit the generated script after the fact when you run the and SQL functions." msgstr "" #. Tag: para -#: installation.xml:968 +#: installation.xml:993 #, no-c-format msgid "If you are installing Tiger geocoder for the first time edit either the create_geocode.bat script If you are on windows or the create_geocode.sh if you are on Linux/Unix/Mac OSX with your PostgreSQL specific settings and run the corresponding script from the commandline." msgstr "" #. Tag: para -#: installation.xml:972 +#: installation.xml:997 #, no-c-format msgid "Verify that you now have a tiger schema in your database and that it is part of your database search_path. If it is not, add it with a command something along the line of:" msgstr "" #. Tag: programlisting -#: installation.xml:972 +#: installation.xml:997 #, no-c-format msgid "ALTER DATABASE geocoder SET search_path=public, tiger;" msgstr "" #. Tag: para -#: installation.xml:973 +#: installation.xml:998 #, no-c-format msgid "The normalizing address functionality works more or less without any data except for tricky addresses. Run this test and verify things look like this:" msgstr "" #. Tag: programlisting -#: installation.xml:974 +#: installation.xml:999 #, no-c-format msgid "" "SELECT pprint_addy(normalize_address('202 East Fremont Street, Las Vegas, Nevada 89101')) As pretty_address;\n" @@ -1619,349 +2030,355 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:977 +#: installation.xml:1002 #, no-c-format msgid "Using Address Standardizer Extension with Tiger geocoder" msgstr "" #. Tag: para -#: installation.xml:978 +#: installation.xml:1003 #, no-c-format msgid "One of the many complaints of folks is the address normalizer function function that normalizes an address for prepping before geocoding. The normalizer is far from perfect and trying to patch its imperfectness takes a vast amount of resources. As such we have integrated with another project that has a much better address standardizer engine. To use this new address_standardizer, you compile the extension as described in and install as an extension in your database." msgstr "" #. Tag: para -#: installation.xml:981 +#: installation.xml:1006 #, no-c-format msgid "Once you install this extension in the same database as you have installed postgis_tiger_geocoder, then the can be used instead of . This extension is tiger agnostic, so can be used with other data sources such as international addresses. The tiger geocoder extension does come packaged with its own custom versions of ( tiger.pagc_rules) , (tiger.pagc_gaz), and (tiger.pagc_lex). These you can add and update to improve your standardizing experience for your own needs." msgstr "" #. Tag: title -#: installation.xml:984 +#: installation.xml:1009 #, no-c-format msgid "Loading Tiger Data" msgstr "" #. Tag: para -#: installation.xml:985 +#: installation.xml:1010 #, no-c-format msgid "The instructions for loading data are available in a more detailed form in the extras/tiger_geocoder/tiger_2011/README. This just includes the general steps." msgstr "" #. Tag: para -#: installation.xml:986 +#: installation.xml:1011 #, no-c-format msgid "The load process downloads data from the census website for the respective nation files, states requested, extracts the files, and then loads each state into its own separate set of state tables. Each state table inherits from the tables defined in tiger schema so that its sufficient to just query those tables to access all the data and drop a set of state tables at any time using the if you need to reload a state or just don't need a state anymore." msgstr "" #. Tag: para -#: installation.xml:988 +#: installation.xml:1013 #, no-c-format msgid "In order to be able to load data you'll need the following tools:" msgstr "" #. Tag: para -#: installation.xml:990 +#: installation.xml:1015 #, no-c-format msgid "A tool to unzip the zip files from census website." msgstr "" #. Tag: para -#: installation.xml:991 +#: installation.xml:1016 #, no-c-format msgid "For Unix like systems: unzip executable which is usually already installed on most Unix like platforms." msgstr "" #. Tag: para -#: installation.xml:992 +#: installation.xml:1017 #, no-c-format msgid "For Windows, 7-zip which is a free compress/uncompress tool you can download from http://www.7-zip.org/" msgstr "" #. Tag: para -#: installation.xml:994 +#: installation.xml:1019 #, no-c-format msgid "shp2pgsql commandline which is installed by default when you install PostGIS." msgstr "" #. Tag: para -#: installation.xml:995 +#: installation.xml:1020 #, no-c-format msgid "wget which is a web grabber tool usually installed on most Unix/Linux systems." msgstr "" #. Tag: para -#: installation.xml:996 +#: installation.xml:1021 #, no-c-format msgid "If you are on windows, you can get pre-compiled binaries from http://gnuwin32.sourceforge.net/packages/wget.htm" msgstr "" #. Tag: para -#: installation.xml:999 +#: installation.xml:1024 #, no-c-format msgid "If you are upgrading from tiger_2010, you'll need to first generate and run . Before you load any state data, you need to load the nation wide data which you do with . Which will generate a loader script for you. is a one-time step that should be done for upgrading (from 2010) and for new installs." msgstr "" #. Tag: para -#: installation.xml:1001 +#: installation.xml:1026 #, no-c-format msgid "To load state data refer to to generate a data load script for your platform for the states you desire. Note that you can install these piecemeal. You don't have to load all the states you want all at once. You can load them as you need them." msgstr "" #. Tag: para -#: installation.xml:1004 +#: installation.xml:1029 #, no-c-format msgid "After the states you desire have been loaded, make sure to run the: SELECT install_missing_indexes(); as described in ." msgstr "" #. Tag: para -#: installation.xml:1006 +#: installation.xml:1031 #, no-c-format msgid "To test that things are working as they should, try to run a geocode on an address in your state using " msgstr "" #. Tag: title -#: installation.xml:1009 +#: installation.xml:1034 #, no-c-format msgid "Upgrading your Tiger Geocoder Install" msgstr "" #. Tag: para -#: installation.xml:1010 +#: installation.xml:1035 #, no-c-format msgid "If you have Tiger Geocoder packaged with 2.0+ already installed, you can upgrade the functions at any time even from an interim tar ball if there are fixes you badly need. This will only work for Tiger geocoder not installed with extensions." msgstr "" +#. Tag: command +#: installation.xml:1048 +#, no-c-format +msgid "cd postgis-&last_release_version;/extras/tiger_geocoder/tiger_2011" +msgstr "" + #. Tag: para -#: installation.xml:1026 +#: installation.xml:1051 #, no-c-format msgid "Locate the upgrade_geocoder.bat script If you are on windows or the upgrade_geocoder.sh if you are on Linux/Unix/Mac OSX. Edit the file to have your postgis database credentials." msgstr "" #. Tag: para -#: installation.xml:1029 +#: installation.xml:1054 #, no-c-format msgid "If you are upgrading from 2010 or 2011, make sure to unremark out the loader script line so you get the latest script for loading 2012 data." msgstr "" #. Tag: para -#: installation.xml:1030 +#: installation.xml:1055 #, no-c-format msgid "Then run th corresponding script from the commandline." msgstr "" #. Tag: para -#: installation.xml:1034 +#: installation.xml:1059 #, no-c-format msgid "Next drop all nation tables and load up the new ones. Generate a drop script with this SQL statement as detailed in " msgstr "" #. Tag: programlisting -#: installation.xml:1035 +#: installation.xml:1060 #, no-c-format msgid "SELECT drop_nation_tables_generate_script();" msgstr "" #. Tag: para -#: installation.xml:1036 +#: installation.xml:1061 #, no-c-format msgid "Run the generated drop SQL statements." msgstr "" #. Tag: para -#: installation.xml:1037 +#: installation.xml:1062 #, no-c-format msgid "Generate a nation load script with this SELECT statement as detailed in " msgstr "" #. Tag: emphasis -#: installation.xml:1038 +#: installation.xml:1063 #, no-c-format msgid "For windows" msgstr "" #. Tag: programlisting -#: installation.xml:1039 +#: installation.xml:1064 #, no-c-format msgid "SELECT loader_generate_nation_script('windows');" msgstr "" #. Tag: emphasis -#: installation.xml:1040 +#: installation.xml:1065 #, no-c-format msgid "For unix/linux" msgstr "" #. Tag: programlisting -#: installation.xml:1041 +#: installation.xml:1066 #, no-c-format msgid "SELECT loader_generate_nation_script('sh');" msgstr "" #. Tag: para -#: installation.xml:1042 +#: installation.xml:1067 #, no-c-format msgid "Refer to for instructions on how to run the generate script. This only needs to be done once." msgstr "" #. Tag: para -#: installation.xml:1043 +#: installation.xml:1068 #, no-c-format msgid "You can have a mix of 2010/2011 state tables and can upgrade each state separately. Before you upgrade a state to 2011, you first need to drop the 2010 tables for that state using ." msgstr "" #. Tag: title -#: installation.xml:1049 +#: installation.xml:1074 #, no-c-format msgid "Create a spatially-enabled database from a template" msgstr "" #. Tag: para -#: installation.xml:1051 +#: installation.xml:1076 #, no-c-format msgid "Some packaged distributions of PostGIS (in particular the Win32 installers for PostGIS >= 1.1.5) load the PostGIS functions into a template database called template_postgis. If the template_postgis database exists in your PostgreSQL installation then it is possible for users and/or applications to create spatially-enabled databases using a single command. Note that in both cases, the database user must have been granted the privilege to create new databases." msgstr "" #. Tag: para -#: installation.xml:1062 +#: installation.xml:1087 #, no-c-format msgid "From the shell:" msgstr "" #. Tag: programlisting -#: installation.xml:1066 +#: installation.xml:1091 #, no-c-format msgid "# createdb -T template_postgis my_spatial_db" msgstr "" #. Tag: para -#: installation.xml:1068 +#: installation.xml:1093 #, no-c-format msgid "From SQL:" msgstr "" #. Tag: programlisting -#: installation.xml:1072 +#: installation.xml:1097 #, no-c-format msgid "postgres=# CREATE DATABASE my_spatial_db TEMPLATE=template_postgis" msgstr "" #. Tag: title -#: installation.xml:1076 +#: installation.xml:1101 #, no-c-format msgid "Upgrading" msgstr "" #. Tag: para -#: installation.xml:1078 +#: installation.xml:1103 #, no-c-format msgid "Upgrading existing spatial databases can be tricky as it requires replacement or introduction of new PostGIS object definitions." msgstr "" #. Tag: para -#: installation.xml:1083 +#: installation.xml:1108 #, no-c-format msgid "Unfortunately not all definitions can be easily replaced in a live database, so sometimes your best bet is a dump/reload process." msgstr "" #. Tag: para -#: installation.xml:1088 +#: installation.xml:1113 #, no-c-format msgid "PostGIS provides a SOFT UPGRADE procedure for minor or bugfix releases, and a HARD UPGRADE procedure for major releases." msgstr "" #. Tag: para -#: installation.xml:1093 +#: installation.xml:1118 #, no-c-format msgid "Before attempting to upgrade PostGIS, it is always worth to backup your data. If you use the -Fc flag to pg_dump you will always be able to restore the dump with a HARD UPGRADE." msgstr "" #. Tag: title -#: installation.xml:1100 +#: installation.xml:1125 #, no-c-format msgid "Soft upgrade" msgstr "" #. Tag: para -#: installation.xml:1102 +#: installation.xml:1127 #, no-c-format msgid "If you installed your database using extensions, you'll need to upgrade using the extension model as well. If you installed using the old sql script way, then you should upgrade using the sql script way. Please refer to the appropriate." msgstr "" #. Tag: title -#: installation.xml:1105 +#: installation.xml:1130 #, no-c-format msgid "Soft Upgrade Pre 9.1+ or without extensions" msgstr "" #. Tag: para -#: installation.xml:1106 +#: installation.xml:1131 #, no-c-format msgid "This section applies only to those who installed PostGIS not using extensions. If you have extensions and try to upgrade with this approach you'll get messages like:" msgstr "" #. Tag: programlisting -#: installation.xml:1107 +#: installation.xml:1132 #, no-c-format msgid "can't drop ... because postgis extension depends on it" msgstr "" #. Tag: para -#: installation.xml:1108 +#: installation.xml:1133 #, no-c-format msgid "After compiling and installing (make install) you should find a postgis_upgrade.sql and rtpostgis_upgrade.sql in the installation folders. For example /usr/share/postgresql/9.3/contrib/postgis_upgrade.sql. Install the postgis_upgrade.sql. If you have raster functionality installed, you will also need to install the /usr/share/postgresql/9.3/contrib/postgis_upgrade.sql. If you are moving from PostGIS 1.* to PostGIS 2.* or from PostGIS 2.* prior to r7409, you need to do a HARD UPGRADE." msgstr "" #. Tag: programlisting -#: installation.xml:1112 +#: installation.xml:1137 #, no-c-format msgid "psql -f postgis_upgrade.sql -d your_spatial_database" msgstr "" #. Tag: para -#: installation.xml:1114 +#: installation.xml:1139 #, no-c-format msgid "The same procedure applies to raster and topology extensions, with upgrade files named rtpostgis_upgrade*.sql and topology_upgrade*.sql respectively. If you need them:" msgstr "" #. Tag: programlisting -#: installation.xml:1122 +#: installation.xml:1147 #, no-c-format msgid "psql -f rtpostgis_upgrade.sql -d your_spatial_database" msgstr "" #. Tag: programlisting -#: installation.xml:1123 +#: installation.xml:1148 #, no-c-format msgid "psql -f topology_upgrade.sql -d your_spatial_database" msgstr "" #. Tag: para -#: installation.xml:1126 +#: installation.xml:1151 #, no-c-format msgid "If you can't find the postgis_upgrade*.sql specific for upgrading your version you are using a version too early for a soft upgrade and need to do a HARD UPGRADE." msgstr "" #. Tag: para -#: installation.xml:1132 +#: installation.xml:1157 #, no-c-format msgid "The function should inform you about the need to run this kind of upgrade using a \"procs need upgrade\" message." msgstr "" #. Tag: title -#: installation.xml:1139 +#: installation.xml:1164 #, no-c-format msgid "Soft Upgrade 9.1+ using extensions" msgstr "" #. Tag: para -#: installation.xml:1140 +#: installation.xml:1165 #, no-c-format msgid "If you originally installed PostGIS with extensions, then you need to upgrade using extensions as well. Doing a minor upgrade with extensions, is fairly painless." msgstr "" #. Tag: programlisting -#: installation.xml:1141 +#: installation.xml:1166 #, no-c-format msgid "" "ALTER EXTENSION postgis UPDATE TO \"&last_release_version;\";\n" @@ -1969,43 +2386,43 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1142 +#: installation.xml:1167 #, no-c-format msgid "If you get an error notice something like:" msgstr "" #. Tag: programlisting -#: installation.xml:1143 +#: installation.xml:1168 #, no-c-format msgid "No migration path defined for ... to &last_release_version;" msgstr "" #. Tag: para -#: installation.xml:1144 +#: installation.xml:1169 #, no-c-format msgid "Then you'll need to backup your database, create a fresh one as described in and then restore your backup ontop of this new database." msgstr "" #. Tag: para -#: installation.xml:1145 +#: installation.xml:1170 #, no-c-format msgid "If you get a notice message like:" msgstr "" #. Tag: programlisting -#: installation.xml:1146 +#: installation.xml:1171 #, no-c-format msgid "Version \"&last_release_version;\" of extension \"postgis\" is already installed" msgstr "" #. Tag: para -#: installation.xml:1147 +#: installation.xml:1172 #, no-c-format msgid "Then everything is already up to date and you can safely ignore it. UNLESS you're attempting to upgrade from an SVN version to the next (which doesn't get a new version number); in that case you can append \"next\" to the version string, and next time you'll need to drop the \"next\" suffix again:" msgstr "" #. Tag: programlisting -#: installation.xml:1153 +#: installation.xml:1178 #, no-c-format msgid "" "ALTER EXTENSION postgis UPDATE TO \"&last_release_version;next\";\n" @@ -2013,229 +2430,187 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1154 +#: installation.xml:1179 #, no-c-format msgid "If you installed PostGIS originally without a version specified, you can often skip the reinstallation of postgis extension before restoring since the backup just has CREATE EXTENSION postgis and thus picks up the newest latest version during restore." msgstr "" #. Tag: title -#: installation.xml:1161 +#: installation.xml:1186 #, no-c-format msgid "Hard upgrade" msgstr "" #. Tag: para -#: installation.xml:1163 +#: installation.xml:1188 #, no-c-format msgid "By HARD UPGRADE we mean full dump/reload of postgis-enabled databases. You need a HARD UPGRADE when PostGIS objects' internal storage changes or when SOFT UPGRADE is not possible. The Release Notes appendix reports for each version whether you need a dump/reload (HARD UPGRADE) to upgrade." msgstr "" #. Tag: para -#: installation.xml:1172 +#: installation.xml:1197 #, no-c-format msgid "The dump/reload process is assisted by the postgis_restore.pl script which takes care of skipping from the dump all definitions which belong to PostGIS (including old ones), allowing you to restore your schemas and data into a database with PostGIS installed without getting duplicate symbol errors or bringing forward deprecated objects." msgstr "" #. Tag: para -#: installation.xml:1181 +#: installation.xml:1206 #, no-c-format msgid "Supplementary instructions for windows users are available at Windows Hard upgrade." msgstr "" #. Tag: para -#: installation.xml:1184 +#: installation.xml:1209 #, no-c-format msgid "The Procedure is as follows:" msgstr "" #. Tag: para -#: installation.xml:1192 +#: installation.xml:1217 #, no-c-format msgid "Create a \"custom-format\" dump of the database you want to upgrade (let's call it olddb) include binary blobs (-b) and verbose (-v) output. The user can be the owner of the db, need not be postgres super account." msgstr "" #. Tag: programlisting -#: installation.xml:1200 +#: installation.xml:1225 #, no-c-format msgid "pg_dump -h localhost -p 5432 -U postgres -Fc -b -v -f \"/somepath/olddb.backup\" olddb" msgstr "" #. Tag: para -#: installation.xml:1206 +#: installation.xml:1231 #, no-c-format msgid "Do a fresh install of PostGIS in a new database -- we'll refer to this database as newdb. Please refer to and for instructions on how to do this." msgstr "" #. Tag: para -#: installation.xml:1213 +#: installation.xml:1238 #, no-c-format msgid "The spatial_ref_sys entries found in your dump will be restored, but they will not override existing ones in spatial_ref_sys. This is to ensure that fixes in the official set will be properly propagated to restored databases. If for any reason you really want your own overrides of standard entries just don't load the spatial_ref_sys.sql file when creating the new db." msgstr "" #. Tag: para -#: installation.xml:1223 +#: installation.xml:1248 #, no-c-format msgid "If your database is really old or you know you've been using long deprecated functions in your views and functions, you might need to load legacy.sql for all your functions and views etc. to properly come back. Only do this if _really_ needed. Consider upgrading your views and functions before dumping instead, if possible. The deprecated functions can be later removed by loading uninstall_legacy.sql." msgstr "" #. Tag: para -#: installation.xml:1239 +#: installation.xml:1264 #, no-c-format msgid "Restore your backup into your fresh newdb database using postgis_restore.pl. Unexpected errors, if any, will be printed to the standard error stream by psql. Keep a log of those." msgstr "" #. Tag: programlisting -#: installation.xml:1247 +#: installation.xml:1272 #, no-c-format msgid "perl utils/postgis_restore.pl \"/somepath/olddb.backup\" | psql -h localhost -p 5432 -U postgres newdb 2> errors.txt" msgstr "" #. Tag: para -#: installation.xml:1253 +#: installation.xml:1278 #, no-c-format msgid "Errors may arise in the following cases:" msgstr "" #. Tag: para -#: installation.xml:1259 +#: installation.xml:1284 #, no-c-format msgid "Some of your views or functions make use of deprecated PostGIS objects. In order to fix this you may try loading legacy.sql script prior to restore or you'll have to restore to a version of PostGIS which still contains those objects and try a migration again after porting your code. If the legacy.sql way works for you, don't forget to fix your code to stop using deprecated functions and drop them loading uninstall_legacy.sql." msgstr "" #. Tag: para -#: installation.xml:1271 +#: installation.xml:1296 #, no-c-format msgid "Some custom records of spatial_ref_sys in dump file have an invalid SRID value. Valid SRID values are bigger than 0 and smaller than 999000. Values in the 999000.999999 range are reserved for internal use while values > 999999 can't be used at all. All your custom records with invalid SRIDs will be retained, with those > 999999 moved into the reserved range, but the spatial_ref_sys table would loose a check constraint guarding for that invariant to hold and possibly also its primary key ( when multiple invalid SRIDS get converted to the same reserved SRID value )." msgstr "" #. Tag: para -#: installation.xml:1285 +#: installation.xml:1310 #, 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:" msgstr "" #. Tag: programlisting -#: installation.xml:1292 +#: installation.xml:1317 #, 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:1294 +#: installation.xml:1319 #, no-c-format msgid "ALTER TABLE spatial_ref_sys ADD PRIMARY KEY(srid));" msgstr "" #. Tag: title -#: installation.xml:1305 +#: installation.xml:1330 #, no-c-format msgid "Common Problems during installation" msgstr "" #. Tag: para -#: installation.xml:1306 +#: installation.xml:1331 #, no-c-format msgid "There are several things to check when your installation or upgrade doesn't go as you expected." msgstr "" #. Tag: para -#: installation.xml:1313 +#: installation.xml:1338 #, no-c-format msgid "Check that you have installed PostgreSQL &min_postgres_version; or newer, and that you are compiling against the same version of the PostgreSQL source as the version of PostgreSQL that is running. Mix-ups can occur when your (Linux) distribution has already installed PostgreSQL, or you have otherwise installed PostgreSQL before and forgotten about it. PostGIS will only work with PostgreSQL &min_postgres_version; or newer, and strange, unexpected error messages will result if you use an older version. To check the version of PostgreSQL which is running, connect to the database using psql and run this query:" msgstr "" #. Tag: programlisting -#: installation.xml:1326 +#: installation.xml:1351 #, no-c-format msgid "SELECT version();" msgstr "" #. Tag: para -#: installation.xml:1328 +#: installation.xml:1353 #, no-c-format msgid "If you are running an RPM based distribution, you can check for the existence of pre-installed packages using the rpm command as follows: rpm -qa | grep postgresql" msgstr "" #. Tag: para -#: installation.xml:1336 +#: installation.xml:1361 #, no-c-format msgid "If your upgrade fails, make sure you are restoring into a database that already has PostGIS installed." msgstr "" #. Tag: programlisting -#: installation.xml:1337 +#: installation.xml:1362 #, no-c-format msgid "SELECT postgis_full_version();" msgstr "" #. Tag: para -#: installation.xml:1341 +#: installation.xml:1366 #, no-c-format msgid "Also check that configure has correctly detected the location and version of PostgreSQL, the Proj4 library and the GEOS library." msgstr "" #. Tag: para -#: installation.xml:1348 +#: installation.xml:1373 #, no-c-format msgid "The output from configure is used to generate the postgis_config.h file. Check that the POSTGIS_PGSQL_VERSION, POSTGIS_PROJ_VERSION and POSTGIS_GEOS_VERSION variables have been set correctly." msgstr "" #. Tag: title -#: installation.xml:1361 -#, no-c-format -msgid "JDBC" -msgstr "" - -#. Tag: para -#: installation.xml:1363 -#, no-c-format -msgid "The JDBC extensions provide Java objects corresponding to the internal PostGIS types. These objects can be used to write Java clients which query the PostGIS database and draw or do calculations on the GIS data in PostGIS." -msgstr "" - -#. Tag: para -#: installation.xml:1372 -#, no-c-format -msgid "Enter the java/jdbc sub-directory of the PostGIS distribution." -msgstr "" - -#. Tag: para -#: installation.xml:1379 -#, no-c-format -msgid "Run the ant command. Copy the postgis.jar file to wherever you keep your java libraries." -msgstr "" - -#. Tag: para -#: installation.xml:1387 -#, no-c-format -msgid "The JDBC extensions require a PostgreSQL JDBC driver to be present in the current CLASSPATH during the build process. If the PostgreSQL JDBC driver is located elsewhere, you may pass the location of the JDBC driver JAR separately using the -D parameter like this:" -msgstr "" - -#. Tag: programlisting -#: installation.xml:1394 -#, no-c-format -msgid "# ant -Dclasspath=/path/to/postgresql-jdbc.jar" -msgstr "" - -#. Tag: para -#: installation.xml:1396 -#, no-c-format -msgid "PostgreSQL JDBC drivers can be downloaded from http://jdbc.postgresql.org ." -msgstr "" - -#. Tag: title -#: installation.xml:1406 +#: installation.xml:1386 #, no-c-format msgid "Loader/Dumper" msgstr "" #. Tag: para -#: installation.xml:1408 +#: installation.xml:1388 #, no-c-format msgid "The data loader and dumper are built and installed automatically as part of the PostGIS build. To build and install them manually:" msgstr "" #. Tag: programlisting -#: installation.xml:1413 +#: installation.xml:1393 #, no-c-format msgid "" "# cd postgis-&last_release_version;/loader\n" @@ -2244,7 +2619,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1415 +#: installation.xml:1395 #, no-c-format msgid "The loader is called shp2pgsql and converts ESRI Shape files into SQL suitable for loading in PostGIS/PostgreSQL. The dumper is called pgsql2shp and converts PostGIS tables (or queries) into ESRI Shape files. For more verbose documentation, see the online help, and the manual pages." msgstr "" diff --git a/doc/po/templates/introduction.xml.pot b/doc/po/templates/introduction.xml.pot index 0b095680f..c706c639e 100644 --- a/doc/po/templates/introduction.xml.pot +++ b/doc/po/templates/introduction.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -263,131 +263,131 @@ msgstr "" #. Tag: para #: introduction.xml:171 #, 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, 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, Nathan Wagner, Nathaniel Clay, Nikita Shulga, Norman Vine, Rafal Magda, Ralph Mason, Richard Greenwood, Silvio Grosso, Steffen Macke, Stephen Frost, Tom van Tilburg, Vincent Mora, Vincent Picavet" +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, 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, Richard Greenwood, Silvio Grosso, Steffen Macke, Stephen Frost, Tom van Tilburg, Vincent Mora, Vincent Picavet" msgstr "" #. Tag: term -#: introduction.xml:232 +#: introduction.xml:233 #, no-c-format msgid "Corporate Sponsors" msgstr "" #. Tag: para -#: introduction.xml:235 +#: introduction.xml:236 #, no-c-format msgid "These are corporate entities that have contributed developer time, hosting, or direct monetary funding to the PostGIS project" msgstr "" #. Tag: para -#: introduction.xml:236 +#: introduction.xml:237 #, no-c-format -msgid "In alphabetical order: Arrival 3D, Associazione Italiana per l'Informazione Geografica Libera (GFOSS.it), AusVet, Avencia, Azavea, Cadcorp, CampToCamp, City of Boston (DND), Clever Elephant Solutions, Cooperativa Alveo, Deimos Space, Faunalia, Geographic Data BC, Hunter Systems Group, Lidwala Consulting Engineers, LisaSoft, Logical Tracking & Tracing International AG, Michigan Tech Research Institute, Natural Resources Canada, Norwegian Forest and Landscape Institute, OpenGeo, OSGeo, Oslandia, Palantir Technologies, Paragon Corporation, R3 GIS, Refractions Research, Regione Toscana-SIGTA, Safe Software, Sirius Corporation plc, Stadt Uster, UC Davis Center for Vectorborne Diseases, University of Laval, U.S Department of State (HIU), Vizzuality, Zonar Systems" +msgid "In alphabetical order: Arrival 3D, Associazione Italiana per l'Informazione Geografica Libera (GFOSS.it), AusVet, Avencia, Azavea, Cadcorp, CampToCamp, City of Boston (DND), Clever Elephant Solutions, Cooperativa Alveo, Deimos Space, Faunalia, Geographic Data BC, Hunter Systems Group, Lidwala Consulting Engineers, LisaSoft, Logical Tracking & Tracing International AG, Michigan Tech Research Institute, 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), CartoDB, Zonar Systems" msgstr "" #. Tag: term -#: introduction.xml:277 +#: introduction.xml:278 #, no-c-format msgid "Crowd Funding Campaigns" msgstr "" #. Tag: para -#: introduction.xml:280 +#: introduction.xml:281 #, 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:281 +#: introduction.xml:282 #, 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." msgstr "" #. Tag: para -#: introduction.xml:282 +#: introduction.xml:283 #, 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." msgstr "" #. Tag: para -#: introduction.xml:283 +#: introduction.xml:284 #, 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." msgstr "" #. Tag: term -#: introduction.xml:288 +#: introduction.xml:289 #, no-c-format msgid "Important Support Libraries" msgstr "" #. Tag: para -#: introduction.xml:291 +#: introduction.xml:292 #, 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." msgstr "" #. Tag: para -#: introduction.xml:296 +#: introduction.xml:297 #, 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." msgstr "" #. Tag: para -#: introduction.xml:301 +#: introduction.xml:302 #, no-c-format msgid "The Proj4 cartographic projection library, and the work of Gerald Evenden and Frank Warmerdam in creating and maintaining it." msgstr "" #. Tag: para -#: introduction.xml:305 +#: introduction.xml:306 #, 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." msgstr "" #. Tag: title -#: introduction.xml:314 +#: introduction.xml:315 #, no-c-format msgid "More Information" msgstr "" #. Tag: para -#: introduction.xml:318 +#: introduction.xml:319 #, no-c-format msgid "The latest software, documentation and news items are available at the PostGIS web site, http://postgis.net." msgstr "" #. Tag: para -#: introduction.xml:324 +#: introduction.xml:325 #, no-c-format msgid "More information about the GEOS geometry operations library is available at http://trac.osgeo.org/geos/." msgstr "" #. Tag: para -#: introduction.xml:330 +#: introduction.xml:331 #, no-c-format msgid "More information about the Proj4 reprojection library is available at http://trac.osgeo.org/proj/." msgstr "" #. Tag: para -#: introduction.xml:336 +#: introduction.xml:337 #, no-c-format msgid "More information about the PostgreSQL database server is available at the PostgreSQL main site http://www.postgresql.org." msgstr "" #. Tag: para -#: introduction.xml:342 +#: introduction.xml:343 #, 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/." msgstr "" #. Tag: para -#: introduction.xml:348 +#: introduction.xml:349 #, no-c-format msgid "More information about MapServer internet map server is available at http://mapserver.org." msgstr "" #. Tag: para -#: introduction.xml:354 +#: introduction.xml:355 #, no-c-format msgid "The "Simple Features for Specification for SQL" is available at the OpenGIS Consortium web site: http://www.opengeospatial.org/." msgstr "" diff --git a/doc/po/templates/postgis.xml.pot b/doc/po/templates/postgis.xml.pot index 021ad0f2e..00871e460 100644 --- a/doc/po/templates/postgis.xml.pot +++ b/doc/po/templates/postgis.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-14 22:30+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -15,37 +15,37 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: postgis.xml:127 +#: postgis.xml:128 #, no-c-format msgid "PostGIS &last_release_version; Manual" msgstr "" #. Tag: corpauthor -#: postgis.xml:131 +#: postgis.xml:132 #, no-c-format msgid "The PostGIS Development Group" msgstr "" #. Tag: affiliation -#: postgis.xml:137 +#: postgis.xml:138 #, no-c-format msgid "clever elephant
Victoria British Columbia Canada pramsey@cleverelephant.ca
" msgstr "" #. Tag: para -#: postgis.xml:151 +#: postgis.xml:152 #, no-c-format msgid "PostGIS is an extension to the PostgreSQL object-relational database system which allows GIS (Geographic Information Systems) objects to be stored in the database. PostGIS includes support for GiST-based R-Tree spatial indexes, and functions for analysis and processing of GIS objects." msgstr "" #. Tag: para -#: postgis.xml:160 +#: postgis.xml:161 #, no-c-format msgid "This is the manual for version &last_release_version;" msgstr "" #. Tag: para -#: postgis.xml:161 +#: postgis.xml:162 #, no-c-format msgid "This work is licensed under a Creative Commons Attribution-Share Alike 3.0 License. Feel free to use this material any way you like, but we ask that you attribute credit to the PostGIS Project and wherever possible, a link back to http://postgis.net." msgstr "" diff --git a/doc/po/templates/reference.xml.pot b/doc/po/templates/reference.xml.pot index bb900fcb7..67fe792c2 100644 --- a/doc/po/templates/reference.xml.pot +++ b/doc/po/templates/reference.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -35,6 +35,6 @@ msgstr "" #. Tag: chapter #: 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_transaction; &reference_misc; &reference_exception;" +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;" msgstr "" diff --git a/doc/po/templates/reference_accessor.xml.pot b/doc/po/templates/reference_accessor.xml.pot index 166e065c8..e74098e32 100644 --- a/doc/po/templates/reference_accessor.xml.pot +++ b/doc/po/templates/reference_accessor.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -39,7 +39,7 @@ msgid "text GeometryType geometry ST_BoundingDiagonal geometry geom boolean fits=false" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:330 +#, 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." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:337 +#, 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:342 +#, 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:350 +#, 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:356 +#, no-c-format +msgid "Availability: 2.2.0" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:358 +#, no-c-format +msgid "&M_support;" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:364 +#, 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:368 +#, no-c-format +msgid ", , , , , , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:382 +#, no-c-format +msgid "ST_ExteriorRing" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:384 +#, 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" msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:319 +#: reference_accessor.xml:390 #, no-c-format msgid "geometry ST_ExteriorRing geometry a_polygon" msgstr "" #. Tag: para -#: reference_accessor.xml:330 +#: reference_accessor.xml:401 #, 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:333 +#: reference_accessor.xml:404 #, no-c-format msgid "Only works with POLYGON geometry types" msgstr "" #. Tag: para -#: reference_accessor.xml:335 reference_accessor.xml:715 +#: reference_accessor.xml:406 reference_accessor.xml:786 #, no-c-format msgid "&sfs_compliant; 2.1.5.1" msgstr "" #. Tag: para -#: reference_accessor.xml:336 +#: reference_accessor.xml:407 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 8.2.3, 8.3.3" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:343 +#: reference_accessor.xml:414 #, no-c-format msgid "" "--If you have a table of polygons\n" @@ -572,67 +645,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:349 +#: reference_accessor.xml:420 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_accessor.xml:359 +#: reference_accessor.xml:430 #, no-c-format msgid "ST_GeometryN" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:361 +#: reference_accessor.xml:432 #, no-c-format msgid "Return the 1-based Nth geometry if the geometry is a GEOMETRYCOLLECTION, (MULTI)POINT, (MULTI)LINESTRING, MULTICURVE or (MULTI)POLYGON, POLYHEDRALSURFACE Otherwise, return NULL." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:368 +#: reference_accessor.xml:439 #, no-c-format msgid "geometry ST_GeometryN geometry geomA integer n" msgstr "" #. Tag: para -#: reference_accessor.xml:379 +#: reference_accessor.xml:450 #, no-c-format msgid "Return the 1-based Nth geometry if the geometry is a GEOMETRYCOLLECTION, (MULTI)POINT, (MULTI)LINESTRING, MULTICURVE or (MULTI)POLYGON, POLYHEDRALSURFACE Otherwise, return NULL" msgstr "" #. Tag: para -#: reference_accessor.xml:384 reference_accessor.xml:1405 +#: reference_accessor.xml:455 reference_accessor.xml:1476 #, no-c-format msgid "Index is 1-based as for OGC specs since version 0.8.0. Previous versions implemented this as 0-based instead." msgstr "" #. Tag: para -#: reference_accessor.xml:389 +#: reference_accessor.xml:460 #, no-c-format msgid "If you want to extract all geometries, of a geometry, ST_Dump is more efficient and will also work for singular geoms." msgstr "" #. Tag: para -#: reference_accessor.xml:392 +#: reference_accessor.xml:463 #, no-c-format msgid "Changed: 2.0.0 Prior versions would return NULL for singular geometries. This was changed to return the geometry for ST_GeometryN(..,1) case." msgstr "" #. Tag: para -#: reference_accessor.xml:394 +#: reference_accessor.xml:465 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 9.1.5" msgstr "" #. Tag: title -#: reference_accessor.xml:404 +#: reference_accessor.xml:475 #, no-c-format msgid "Standard Examples" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:406 +#: reference_accessor.xml:477 #, no-c-format msgid "" "--Extracting a subset of points from a 3d multipoint\n" @@ -661,13 +734,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_accessor.xml:409 +#: reference_accessor.xml:480 #, no-c-format msgid "Polyhedral Surfaces, TIN and Triangle Examples" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:410 +#: reference_accessor.xml:481 #, no-c-format msgid "" "-- Polyhedral surface example\n" @@ -688,7 +761,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:412 +#: reference_accessor.xml:483 #, no-c-format msgid "" "-- TIN -- \n" @@ -715,49 +788,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:419 reference_accessor.xml:1276 +#: reference_accessor.xml:490 reference_accessor.xml:1347 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_accessor.xml:425 +#: reference_accessor.xml:496 #, no-c-format msgid "ST_GeometryType" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:426 +#: reference_accessor.xml:497 #, no-c-format msgid "Return the geometry type of the ST_Geometry value." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:431 +#: reference_accessor.xml:502 #, no-c-format msgid "text ST_GeometryType geometry g1" msgstr "" #. Tag: para -#: reference_accessor.xml:440 +#: reference_accessor.xml:511 #, no-c-format msgid "Returns the type of the geometry as a string. EG: 'ST_Linestring', 'ST_Polygon','ST_MultiPolygon' etc. This function differs from GeometryType(geometry) in the case of the string and ST in front that is returned, as well as the fact that it will not indicate whether the geometry is measured." msgstr "" #. Tag: para -#: reference_accessor.xml:442 reference_accessor.xml:563 reference_accessor.xml:1074 +#: reference_accessor.xml:513 reference_accessor.xml:634 reference_accessor.xml:1145 #, no-c-format msgid "Enhanced: 2.0.0 support for Polyhedral surfaces was introduced." msgstr "" #. Tag: para -#: reference_accessor.xml:443 +#: reference_accessor.xml:514 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.4" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:452 +#: reference_accessor.xml:523 #, no-c-format msgid "" "SELECT ST_GeometryType(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));\n" @@ -766,7 +839,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:454 reference_accessor.xml:456 +#: reference_accessor.xml:525 reference_accessor.xml:527 #, no-c-format msgid "" "SELECT ST_GeometryType(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)), \n" @@ -778,7 +851,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:458 +#: reference_accessor.xml:529 #, no-c-format msgid "" "SELECT ST_GeometryType(geom) as result\n" @@ -803,43 +876,43 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:471 +#: reference_accessor.xml:542 #, no-c-format msgid "ST_InteriorRingN" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:473 +#: reference_accessor.xml:544 #, no-c-format msgid "Return the Nth interior linestring ring of the polygon geometry. Return NULL if the geometry is not a polygon or the given N is out of range." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:480 +#: reference_accessor.xml:551 #, no-c-format msgid "geometry ST_InteriorRingN geometry a_polygon integer n" msgstr "" #. Tag: para -#: reference_accessor.xml:491 +#: reference_accessor.xml:562 #, no-c-format msgid "Return the Nth interior linestring ring of the polygon geometry. Return NULL if the geometry is not a polygon or the given N is out of range. index starts at 1." msgstr "" #. Tag: para -#: reference_accessor.xml:497 +#: reference_accessor.xml:568 #, no-c-format msgid "This will not work for MULTIPOLYGONs. Use in conjunction with ST_Dump for MULTIPOLYGONS" msgstr "" #. Tag: para -#: reference_accessor.xml:501 +#: reference_accessor.xml:572 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 8.2.6, 8.3.5" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:510 +#: reference_accessor.xml:581 #, no-c-format msgid "" "SELECT ST_AsText(ST_InteriorRingN(the_geom, 1)) As the_geom\n" @@ -850,55 +923,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:517 +#: reference_accessor.xml:588 #, no-c-format msgid ", , , ," msgstr "" #. Tag: refname -#: reference_accessor.xml:530 +#: reference_accessor.xml:601 #, no-c-format msgid "ST_IsClosed" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:532 +#: reference_accessor.xml:603 #, no-c-format msgid "Returns TRUE if the LINESTRING's start and end points are coincident. For Polyhedral surface is closed (volumetric)." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:539 +#: reference_accessor.xml:610 #, no-c-format msgid "boolean ST_IsClosed geometry g" msgstr "" #. Tag: para -#: reference_accessor.xml:550 +#: reference_accessor.xml:621 #, no-c-format msgid "Returns TRUE if the LINESTRING's start and end points are coincident. For Polyhedral Surfaces, it tells you if the surface is areal (open) or volumetric (closed)." msgstr "" #. Tag: para -#: reference_accessor.xml:554 +#: reference_accessor.xml:625 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 7.1.5, 9.3.3" msgstr "" #. Tag: para -#: reference_accessor.xml:556 +#: reference_accessor.xml:627 #, no-c-format msgid "SQL-MM defines the result of ST_IsClosed(NULL) to be 0, while PostGIS returns NULL." msgstr "" #. Tag: title -#: reference_accessor.xml:570 +#: reference_accessor.xml:641 #, no-c-format msgid "Line String and Point Examples" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:572 +#: reference_accessor.xml:643 #, no-c-format msgid "" "postgis=# SELECT ST_IsClosed('LINESTRING(0 0, 1 1)'::geometry);\n" @@ -933,13 +1006,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_accessor.xml:576 +#: reference_accessor.xml:647 #, no-c-format msgid "Polyhedral Surface Examples" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:578 +#: reference_accessor.xml:649 #, no-c-format msgid "" "-- A cube --\n" @@ -965,55 +1038,55 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:590 +#: reference_accessor.xml:661 #, no-c-format msgid "ST_IsCollection" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:592 +#: reference_accessor.xml:663 #, no-c-format msgid "Returns TRUE if the argument is a collection (MULTI*, GEOMETRYCOLLECTION, ...)" msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:599 +#: reference_accessor.xml:670 #, no-c-format msgid "boolean ST_IsCollection geometry g" msgstr "" #. Tag: para -#: reference_accessor.xml:609 +#: reference_accessor.xml:680 #, no-c-format msgid "Returns TRUE if the geometry type of the argument is either:" msgstr "" #. Tag: para -#: reference_accessor.xml:612 +#: reference_accessor.xml:683 #, no-c-format msgid "GEOMETRYCOLLECTION" msgstr "" #. Tag: para -#: reference_accessor.xml:613 +#: reference_accessor.xml:684 #, no-c-format msgid "MULTI{POINT,POLYGON,LINESTRING,CURVE,SURFACE}" msgstr "" #. Tag: para -#: reference_accessor.xml:614 +#: reference_accessor.xml:685 #, no-c-format msgid "COMPOUNDCURVE" msgstr "" #. Tag: para -#: reference_accessor.xml:619 +#: reference_accessor.xml:690 #, no-c-format msgid "This function analyzes the type of the geometry. This means that it will return TRUE on collections that are empty or that contain a single element." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:634 +#: reference_accessor.xml:705 #, no-c-format msgid "" "postgis=# SELECT ST_IsCollection('LINESTRING(0 0, 1 1)'::geometry);\n" @@ -1048,49 +1121,49 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:646 +#: reference_accessor.xml:717 #, no-c-format msgid "ST_IsEmpty" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:648 +#: reference_accessor.xml:719 #, no-c-format msgid "Returns true if this Geometry is an empty geometrycollection, polygon, point etc." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:654 +#: reference_accessor.xml:725 #, no-c-format msgid "boolean ST_IsEmpty geometry geomA" msgstr "" #. Tag: para -#: reference_accessor.xml:664 +#: reference_accessor.xml:735 #, no-c-format msgid "Returns true if this Geometry is an empty geometry. If true, then this Geometry represents an empty geometry collection, polygon, point etc." msgstr "" #. Tag: para -#: reference_accessor.xml:667 +#: reference_accessor.xml:738 #, no-c-format msgid "SQL-MM defines the result of ST_IsEmpty(NULL) to be 0, while PostGIS returns NULL." msgstr "" #. Tag: para -#: reference_accessor.xml:672 +#: reference_accessor.xml:743 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.7" msgstr "" #. Tag: para -#: reference_accessor.xml:674 +#: reference_accessor.xml:745 #, no-c-format msgid "Changed: 2.0.0 In prior versions of PostGIS ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') was allowed. This is now illegal in PostGIS 2.0.0 to better conform with SQL/MM standards" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:682 +#: reference_accessor.xml:753 #, no-c-format msgid "" "SELECT ST_IsEmpty(ST_GeomFromText('GEOMETRYCOLLECTION EMPTY'));\n" @@ -1126,43 +1199,43 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:689 +#: reference_accessor.xml:760 #, no-c-format msgid "ST_IsRing" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:691 +#: reference_accessor.xml:762 #, no-c-format msgid "Returns TRUE if this LINESTRING is both closed and simple." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:697 +#: reference_accessor.xml:768 #, no-c-format msgid "boolean ST_IsRing geometry g" msgstr "" #. Tag: para -#: reference_accessor.xml:708 +#: reference_accessor.xml:779 #, no-c-format msgid "Returns TRUE if this LINESTRING is both (ST_StartPoint(g) ~= ST_Endpoint(g)) and (does not self intersect)." msgstr "" #. Tag: para -#: reference_accessor.xml:716 +#: reference_accessor.xml:787 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 7.1.6" msgstr "" #. Tag: para -#: reference_accessor.xml:718 +#: reference_accessor.xml:789 #, no-c-format msgid "SQL-MM defines the result of ST_IsRing(NULL) to be 0, while PostGIS returns NULL." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:727 +#: reference_accessor.xml:798 #, no-c-format msgid "" "SELECT ST_IsRing(the_geom), ST_IsClosed(the_geom), ST_IsSimple(the_geom)\n" @@ -1181,49 +1254,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:733 +#: reference_accessor.xml:804 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:741 +#: reference_accessor.xml:812 #, no-c-format msgid "ST_IsSimple" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:743 +#: reference_accessor.xml:814 #, no-c-format msgid "Returns (TRUE) if this Geometry has no anomalous geometric points, such as self intersection or self tangency." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:749 +#: reference_accessor.xml:820 #, no-c-format msgid "boolean ST_IsSimple geometry geomA" msgstr "" #. Tag: para -#: reference_accessor.xml:759 +#: reference_accessor.xml:830 #, no-c-format msgid "Returns true if this Geometry has no anomalous geometric points, such as self intersection or self tangency. For more information on the OGC's definition of geometry simplicity and validity, refer to \"Ensuring OpenGIS compliancy of geometries\"" msgstr "" #. Tag: para -#: reference_accessor.xml:765 +#: reference_accessor.xml:836 #, no-c-format msgid "SQL-MM defines the result of ST_IsSimple(NULL) to be 0, while PostGIS returns NULL." msgstr "" #. Tag: para -#: reference_accessor.xml:770 +#: reference_accessor.xml:841 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.8" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:778 +#: reference_accessor.xml:849 #, no-c-format msgid "" "SELECT ST_IsSimple(ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))'));\n" @@ -1240,49 +1313,49 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:790 +#: reference_accessor.xml:861 #, no-c-format msgid "ST_IsValid" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:792 +#: reference_accessor.xml:863 #, no-c-format msgid "Returns true if the ST_Geometry is well formed." msgstr "" #. Tag: funcsynopsis -#: reference_accessor.xml:798 +#: reference_accessor.xml:869 #, no-c-format msgid " boolean ST_IsValid geometry g boolean ST_IsValid geometry g integer flags " msgstr "" #. Tag: para -#: reference_accessor.xml:816 +#: reference_accessor.xml:887 #, 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\"" msgstr "" #. Tag: para -#: reference_accessor.xml:822 +#: reference_accessor.xml:893 #, no-c-format msgid "SQL-MM defines the result of ST_IsValid(NULL) to be 0, while PostGIS returns NULL." msgstr "" #. Tag: para -#: reference_accessor.xml:826 +#: reference_accessor.xml:897 #, 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:834 +#: reference_accessor.xml:905 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.9" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:842 +#: reference_accessor.xml:913 #, no-c-format msgid "" "SELECT ST_IsValid(ST_GeomFromText('LINESTRING(0 0, 1 1)')) As good_line,\n" @@ -1295,61 +1368,61 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:848 +#: reference_accessor.xml:919 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:859 +#: reference_accessor.xml:930 #, no-c-format msgid "ST_IsValidReason" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:861 +#: reference_accessor.xml:932 #, 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:865 +#: reference_accessor.xml:936 #, no-c-format msgid " text ST_IsValidReason geometry geomA text ST_IsValidReason geometry geomA integer flags " msgstr "" #. Tag: para -#: reference_accessor.xml:881 +#: reference_accessor.xml:952 #, 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:883 +#: reference_accessor.xml:954 #, 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:885 +#: reference_accessor.xml:956 #, no-c-format msgid "Allowed flags are documented in ." msgstr "" #. Tag: para -#: reference_accessor.xml:889 +#: reference_accessor.xml:960 #, no-c-format msgid "Availability: 1.4 - requires GEOS >= 3.1.0." msgstr "" #. Tag: para -#: reference_accessor.xml:890 +#: reference_accessor.xml:961 #, no-c-format msgid "Availability: 2.0 - requires GEOS >= 3.3.0 for the version taking flags." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:898 +#: reference_accessor.xml:969 #, no-c-format msgid "" "--First 3 Rejects from a successful quintuplet experiment\n" @@ -1387,61 +1460,61 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:905 +#: reference_accessor.xml:976 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_accessor.xml:911 +#: reference_accessor.xml:982 #, no-c-format msgid "ST_IsValidDetail" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:913 +#: reference_accessor.xml:984 #, no-c-format msgid "Returns a valid_detail (valid,reason,location) row stating if a geometry is valid or not and if not valid, a reason why and a location where." msgstr "" #. Tag: funcsynopsis -#: reference_accessor.xml:917 +#: reference_accessor.xml:988 #, no-c-format msgid " valid_detail ST_IsValidDetail geometry geom valid_detail ST_IsValidDetail geometry geom integer flags " msgstr "" #. Tag: para -#: reference_accessor.xml:933 +#: reference_accessor.xml:1004 #, no-c-format msgid "Returns a valid_detail row, formed by a boolean (valid) stating if a geometry is valid, a varchar (reason) stating a reason why it is invalid and a geometry (location) pointing out where it is invalid." msgstr "" #. Tag: para -#: reference_accessor.xml:935 +#: reference_accessor.xml:1006 #, 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:937 +#: reference_accessor.xml:1008 #, no-c-format msgid "The 'flags' argument is a bitfield. It can have the following values:" msgstr "" #. Tag: para -#: reference_accessor.xml:941 +#: reference_accessor.xml:1012 #, no-c-format msgid "1: Consider self-intersecting rings forming holes as valid. This is also know as \"the ESRI flag\". Note that this is against the OGC model." msgstr "" #. Tag: para -#: reference_accessor.xml:950 +#: reference_accessor.xml:1021 #, no-c-format msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:958 +#: reference_accessor.xml:1029 #, no-c-format msgid "" "--First 3 Rejects from a successful quintuplet experiment\n" @@ -1479,49 +1552,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:965 +#: reference_accessor.xml:1036 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_accessor.xml:974 +#: reference_accessor.xml:1045 #, no-c-format msgid "ST_M" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:976 +#: reference_accessor.xml:1047 #, 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:982 +#: reference_accessor.xml:1053 #, no-c-format msgid "float ST_M geometry a_point" msgstr "" #. Tag: para -#: reference_accessor.xml:992 +#: reference_accessor.xml:1063 #, no-c-format msgid "Return the M coordinate of the point, or NULL if not available. Input must be a point." msgstr "" #. Tag: para -#: reference_accessor.xml:996 +#: reference_accessor.xml:1067 #, 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:1000 reference_accessor.xml:1891 +#: reference_accessor.xml:1071 reference_accessor.xml:1962 #, no-c-format msgid "&sqlmm_compliant;" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1008 +#: reference_accessor.xml:1079 #, no-c-format msgid "" "SELECT ST_M(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n" @@ -1532,37 +1605,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1015 +#: reference_accessor.xml:1086 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:1021 +#: reference_accessor.xml:1092 #, no-c-format msgid "ST_NDims" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1022 +#: reference_accessor.xml:1093 #, no-c-format msgid "Returns coordinate dimension of the geometry as a small int. Values are: 2,3 or 4." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1028 +#: reference_accessor.xml:1099 #, no-c-format msgid "integer ST_NDims geometry g1" msgstr "" #. Tag: para -#: reference_accessor.xml:1038 +#: reference_accessor.xml:1109 #, no-c-format msgid "Returns the coordinate dimension of the geometry. PostGIS supports 2 - (x,y) , 3 - (x,y,z) or 2D with measure - x,y,m, and 4 - 3D with measure space x,y,z,m" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1047 +#: reference_accessor.xml:1118 #, no-c-format msgid "" "SELECT ST_NDims(ST_GeomFromText('POINT(1 1)')) As d2point,\n" @@ -1575,43 +1648,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1051 +#: reference_accessor.xml:1122 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_accessor.xml:1057 +#: reference_accessor.xml:1128 #, no-c-format msgid "ST_NPoints" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1058 +#: reference_accessor.xml:1129 #, no-c-format msgid "Return the number of points (vertexes) in a geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1063 +#: reference_accessor.xml:1134 #, no-c-format msgid "integer ST_NPoints geometry g1" msgstr "" #. Tag: para -#: reference_accessor.xml:1073 +#: reference_accessor.xml:1144 #, no-c-format msgid "Return the number of points in a geometry. Works for all geometries." msgstr "" #. Tag: para -#: reference_accessor.xml:1075 +#: reference_accessor.xml:1146 #, 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:1085 +#: reference_accessor.xml:1156 #, no-c-format msgid "" "SELECT ST_NPoints(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));\n" @@ -1625,31 +1698,31 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:1096 +#: reference_accessor.xml:1167 #, no-c-format msgid "ST_NRings" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1097 +#: reference_accessor.xml:1168 #, no-c-format msgid "If the geometry is a polygon or multi-polygon returns the number of rings." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1102 +#: reference_accessor.xml:1173 #, no-c-format msgid "integer ST_NRings geometry geomA" msgstr "" #. Tag: para -#: reference_accessor.xml:1112 +#: reference_accessor.xml:1183 #, no-c-format msgid "If the geometry is a polygon or multi-polygon returns the number of rings. Unlike NumInteriorRings, it counts the outer rings as well." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1122 +#: reference_accessor.xml:1193 #, no-c-format msgid "" "SELECT ST_NRings(the_geom) As Nrings, ST_NumInteriorRings(the_geom) As ninterrings\n" @@ -1661,43 +1734,43 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:1135 +#: reference_accessor.xml:1206 #, no-c-format msgid "ST_NumGeometries" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1136 +#: reference_accessor.xml:1207 #, no-c-format msgid "If geometry is a GEOMETRYCOLLECTION (or MULTI*) return the number of geometries, for single geometries will return 1, otherwise return NULL." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1142 +#: reference_accessor.xml:1213 #, no-c-format msgid "integer ST_NumGeometries geometry geom" msgstr "" #. Tag: para -#: reference_accessor.xml:1152 +#: reference_accessor.xml:1223 #, no-c-format msgid "Returns the number of Geometries. If geometry is a GEOMETRYCOLLECTION (or MULTI*) return the number of geometries, for single geometries will return 1, otherwise return NULL." msgstr "" #. Tag: para -#: reference_accessor.xml:1156 +#: reference_accessor.xml:1227 #, no-c-format msgid "Changed: 2.0.0 In prior versions this would return NULL if the geometry was not a collection/MULTI type. 2.0.0+ now returns 1 for single geometries e.g POLYGON, LINESTRING, POINT." msgstr "" #. Tag: para -#: reference_accessor.xml:1158 +#: reference_accessor.xml:1229 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 9.1.4" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1168 +#: reference_accessor.xml:1239 #, no-c-format msgid "" "--Prior versions would have returned NULL for this -- in 2.0.0 this returns 1\n" @@ -1714,49 +1787,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1173 +#: reference_accessor.xml:1244 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_accessor.xml:1179 +#: reference_accessor.xml:1250 #, no-c-format msgid "ST_NumInteriorRings" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1180 +#: reference_accessor.xml:1251 #, no-c-format msgid "Return the number of interior rings of the a polygon in the geometry. This will work with POLYGON and return NULL for a MULTIPOLYGON type or any other type" msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1186 +#: reference_accessor.xml:1257 #, no-c-format msgid "integer ST_NumInteriorRings geometry a_polygon" msgstr "" #. Tag: para -#: reference_accessor.xml:1196 +#: reference_accessor.xml:1267 #, no-c-format msgid "Return the number of interior rings of the first polygon in the geometry. This will work with both POLYGON and MULTIPOLYGON types but only looks at the first polygon. Return NULL if there is no polygon in the geometry." msgstr "" #. Tag: para -#: reference_accessor.xml:1201 +#: reference_accessor.xml:1272 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 8.2.5" msgstr "" #. Tag: para -#: reference_accessor.xml:1202 +#: reference_accessor.xml:1273 #, no-c-format msgid "Changed: 2.0.0 - in prior versions it would return the number of interior rings for the first POLYGON in a MULTIPOLYGON." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1208 +#: reference_accessor.xml:1279 #, no-c-format msgid "" "--If you have a regular polygon\n" @@ -1772,61 +1845,61 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:1219 +#: reference_accessor.xml:1290 #, no-c-format msgid "ST_NumInteriorRing" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1220 +#: reference_accessor.xml:1291 #, no-c-format msgid "Return the number of interior rings of a polygon in the geometry. Synonym for ST_NumInteriorRings." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1226 +#: reference_accessor.xml:1297 #, no-c-format msgid "integer ST_NumInteriorRing geometry a_polygon" msgstr "" #. Tag: refname -#: reference_accessor.xml:1242 +#: reference_accessor.xml:1313 #, no-c-format msgid "ST_NumPatches" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1243 +#: reference_accessor.xml:1314 #, no-c-format msgid "Return the number of faces on a Polyhedral Surface. Will return null for non-polyhedral geometries." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1248 +#: reference_accessor.xml:1319 #, no-c-format msgid "integer ST_NumPatches geometry g1" msgstr "" #. Tag: para -#: reference_accessor.xml:1258 +#: reference_accessor.xml:1329 #, no-c-format msgid "Return the number of faces on a Polyhedral Surface. Will return null for non-polyhedral geometries. This is an alias for ST_NumGeometries to support MM naming. Faster to use ST_NumGeometries if you don't care about MM convention." msgstr "" #. Tag: para -#: reference_accessor.xml:1261 reference_accessor.xml:1356 +#: reference_accessor.xml:1332 reference_accessor.xml:1427 #, no-c-format msgid "Availability: 2.0.0" msgstr "" #. Tag: para -#: reference_accessor.xml:1264 reference_accessor.xml:1357 +#: reference_accessor.xml:1335 reference_accessor.xml:1428 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: ?" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1271 +#: reference_accessor.xml:1342 #, no-c-format msgid "" "SELECT ST_NumPatches(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)), \n" @@ -1838,37 +1911,37 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:1282 +#: reference_accessor.xml:1353 #, no-c-format msgid "ST_NumPoints" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1283 +#: reference_accessor.xml:1354 #, no-c-format msgid "Return the number of points in an ST_LineString or ST_CircularString value." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1289 +#: reference_accessor.xml:1360 #, no-c-format msgid "integer ST_NumPoints geometry g1" msgstr "" #. Tag: para -#: reference_accessor.xml:1299 +#: reference_accessor.xml:1370 #, no-c-format msgid "Return the number of points in an ST_LineString or ST_CircularString value. Prior to 1.4 only works with Linestrings as the specs state. From 1.4 forward this is an alias for ST_NPoints which returns number of vertexes for not just line strings. Consider using ST_NPoints instead which is multi-purpose and works with many geometry types." msgstr "" #. Tag: para -#: reference_accessor.xml:1306 +#: reference_accessor.xml:1377 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 7.2.4" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1312 +#: reference_accessor.xml:1383 #, no-c-format msgid "" "SELECT ST_NumPoints(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));\n" @@ -1877,43 +1950,43 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:1323 +#: reference_accessor.xml:1394 #, no-c-format msgid "ST_PatchN" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1325 +#: reference_accessor.xml:1396 #, no-c-format msgid "Return the 1-based Nth geometry (face) if the geometry is a POLYHEDRALSURFACE, POLYHEDRALSURFACEM. Otherwise, return NULL." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1332 +#: reference_accessor.xml:1403 #, no-c-format msgid "geometry ST_PatchN geometry geomA integer n" msgstr "" #. Tag: para -#: reference_accessor.xml:1343 +#: reference_accessor.xml:1414 #, no-c-format msgid ">Return the 1-based Nth geometry (face) if the geometry is a POLYHEDRALSURFACE, POLYHEDRALSURFACEM. Otherwise, return NULL. This returns the same answer as ST_GeometryN for Polyhedral Surfaces. Using ST_GemoetryN is faster." msgstr "" #. Tag: para -#: reference_accessor.xml:1349 +#: reference_accessor.xml:1420 #, no-c-format msgid "Index is 1-based." msgstr "" #. Tag: para -#: reference_accessor.xml:1353 +#: reference_accessor.xml:1424 #, no-c-format msgid "If you want to extract all geometries, of a geometry, ST_Dump is more efficient." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1367 +#: reference_accessor.xml:1438 #, no-c-format msgid "" "--Extract the 2nd face of the polyhedral surface\n" @@ -1930,55 +2003,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1374 +#: reference_accessor.xml:1445 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:1380 +#: reference_accessor.xml:1451 #, no-c-format msgid "ST_PointN" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1382 +#: reference_accessor.xml:1453 #, no-c-format msgid "Return the Nth point in the first linestring or circular linestring in the geometry. Return NULL if there is no linestring in the geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1389 +#: reference_accessor.xml:1460 #, no-c-format msgid "geometry ST_PointN geometry a_linestring integer n" msgstr "" #. Tag: para -#: reference_accessor.xml:1400 +#: reference_accessor.xml:1471 #, no-c-format msgid "Return the Nth point in a single linestring or circular linestring in the geometry. Return NULL if there is no linestring in the geometry." msgstr "" #. Tag: para -#: reference_accessor.xml:1410 +#: reference_accessor.xml:1481 #, no-c-format msgid "If you want to get the nth point of each line string in a multilinestring, use in conjunction with ST_Dump" msgstr "" #. Tag: para -#: reference_accessor.xml:1415 +#: reference_accessor.xml:1486 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 7.2.5, 7.3.5" msgstr "" #. Tag: para -#: reference_accessor.xml:1418 +#: reference_accessor.xml:1489 #, 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." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1428 +#: reference_accessor.xml:1499 #, no-c-format msgid "" "-- Extract all POINTs from a LINESTRING\n" @@ -2005,43 +2078,43 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:1440 +#: reference_accessor.xml:1511 #, no-c-format msgid "ST_SRID" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1441 +#: reference_accessor.xml:1512 #, no-c-format msgid "Returns the spatial reference identifier for the ST_Geometry as defined in spatial_ref_sys table." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1446 +#: reference_accessor.xml:1517 #, no-c-format msgid "integer ST_SRID geometry g1" msgstr "" #. Tag: para -#: reference_accessor.xml:1456 +#: reference_accessor.xml:1527 #, no-c-format msgid "Returns the spatial reference identifier for the ST_Geometry as defined in spatial_ref_sys table. " msgstr "" #. Tag: para -#: reference_accessor.xml:1457 +#: reference_accessor.xml:1528 #, no-c-format msgid "spatial_ref_sys table is a table that catalogs all spatial reference systems known to PostGIS and is used for transformations from one spatial reference system to another. So verifying you have the right spatial reference system identifier is important if you plan to ever transform your geometries." msgstr "" #. Tag: para -#: reference_accessor.xml:1461 +#: reference_accessor.xml:1532 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.5" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1469 +#: reference_accessor.xml:1540 #, no-c-format msgid "" "SELECT ST_SRID(ST_GeomFromText('POINT(-71.1043 42.315)',4326));\n" @@ -2050,43 +2123,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1474 +#: reference_accessor.xml:1545 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:1480 +#: reference_accessor.xml:1551 #, no-c-format msgid "ST_StartPoint" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1482 +#: reference_accessor.xml:1553 #, no-c-format msgid "Returns the first point of a LINESTRING geometry as a POINT." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1488 +#: reference_accessor.xml:1559 #, no-c-format msgid "geometry ST_StartPoint geometry geomA" msgstr "" #. Tag: para -#: reference_accessor.xml:1499 +#: reference_accessor.xml:1570 #, no-c-format msgid "Returns the first point of a LINESTRING or CIRCULARLINESTRING geometry as a POINT or NULL if the input parameter is not a LINESTRING or CIRCULARLINESTRING." msgstr "" #. Tag: para -#: reference_accessor.xml:1503 +#: reference_accessor.xml:1574 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 7.1.3" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1518 +#: reference_accessor.xml:1589 #, no-c-format msgid "" "SELECT ST_AsText(ST_StartPoint('LINESTRING(0 1, 0 2)'::geometry));\n" @@ -2116,91 +2189,91 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1524 +#: reference_accessor.xml:1595 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_accessor.xml:1529 +#: reference_accessor.xml:1600 #, no-c-format msgid "ST_Summary" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1531 +#: reference_accessor.xml:1602 #, no-c-format msgid "Returns a text summary of the contents of the geometry." msgstr "" #. Tag: funcsynopsis -#: reference_accessor.xml:1537 +#: reference_accessor.xml:1608 #, no-c-format msgid " text ST_Summary geometry g text ST_Summary geography g " msgstr "" #. Tag: para -#: reference_accessor.xml:1552 +#: reference_accessor.xml:1623 #, no-c-format msgid "Returns a text summary of the contents of the geometry." msgstr "" #. Tag: para -#: reference_accessor.xml:1554 +#: reference_accessor.xml:1625 #, no-c-format msgid "Flags shown square brackets after the geometry type have the following meaning:" msgstr "" #. Tag: para -#: reference_accessor.xml:1558 +#: reference_accessor.xml:1629 #, no-c-format msgid "M: has M ordinate" msgstr "" #. Tag: para -#: reference_accessor.xml:1559 +#: reference_accessor.xml:1630 #, no-c-format msgid "Z: has Z ordinate" msgstr "" #. Tag: para -#: reference_accessor.xml:1560 +#: reference_accessor.xml:1631 #, no-c-format msgid "B: has a cached bounding box" msgstr "" #. Tag: para -#: reference_accessor.xml:1561 +#: reference_accessor.xml:1632 #, no-c-format msgid "G: is geodetic (geography)" msgstr "" #. Tag: para -#: reference_accessor.xml:1562 +#: reference_accessor.xml:1633 #, no-c-format msgid "S: has spatial reference system" msgstr "" #. Tag: para -#: reference_accessor.xml:1566 +#: reference_accessor.xml:1637 #, no-c-format msgid "Availability: 1.2.2" msgstr "" #. Tag: para -#: reference_accessor.xml:1567 +#: reference_accessor.xml:1638 #, no-c-format msgid "Enhanced: 2.0.0 added support for geography" msgstr "" #. Tag: para -#: reference_accessor.xml:1568 +#: reference_accessor.xml:1639 #, no-c-format msgid "Enhanced: 2.1.0 S flag to denote if has a known spatial reference system" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1575 +#: reference_accessor.xml:1646 #, no-c-format msgid "" "=# SELECT ST_Summary(ST_GeomFromText('LINESTRING(0 0, 1 1)')) as geom,\n" @@ -2225,55 +2298,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1581 +#: reference_accessor.xml:1652 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: para -#: reference_accessor.xml:1590 +#: reference_accessor.xml:1661 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:1601 +#: reference_accessor.xml:1672 #, no-c-format msgid "ST_X" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1603 +#: reference_accessor.xml:1674 #, no-c-format msgid "Return the X coordinate of the point, or NULL if not available. Input must be a point." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1609 +#: reference_accessor.xml:1680 #, no-c-format msgid "float ST_X geometry a_point" msgstr "" #. Tag: para -#: reference_accessor.xml:1619 +#: reference_accessor.xml:1690 #, no-c-format msgid "Return the X coordinate of the point, or NULL if not available. Input must be a point." msgstr "" #. Tag: para -#: reference_accessor.xml:1622 +#: reference_accessor.xml:1693 #, no-c-format msgid "If you want to get the max min x values of any geometry look at ST_XMin, ST_XMax functions." msgstr "" #. Tag: para -#: reference_accessor.xml:1624 +#: reference_accessor.xml:1695 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 6.1.3" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1632 +#: reference_accessor.xml:1703 #, no-c-format msgid "" "SELECT ST_X(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n" @@ -2290,43 +2363,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1639 +#: reference_accessor.xml:1710 #, no-c-format msgid ", , , , , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:1645 +#: reference_accessor.xml:1716 #, no-c-format msgid "ST_XMax" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1647 +#: reference_accessor.xml:1718 #, no-c-format msgid "Returns X maxima of a bounding box 2d or 3d or a geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1652 +#: reference_accessor.xml:1723 #, no-c-format msgid "float ST_XMax box3d aGeomorBox2DorBox3D" msgstr "" #. Tag: para -#: reference_accessor.xml:1662 +#: reference_accessor.xml:1733 #, no-c-format msgid "Returns X maxima of a bounding box 2d or 3d or a geometry." msgstr "" #. Tag: para -#: reference_accessor.xml:1665 reference_accessor.xml:1710 reference_accessor.xml:1798 reference_accessor.xml:1843 reference_accessor.xml:1931 reference_accessor.xml:2018 +#: reference_accessor.xml:1736 reference_accessor.xml:1781 reference_accessor.xml:1869 reference_accessor.xml:1914 reference_accessor.xml:2002 reference_accessor.xml:2089 #, 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:1677 +#: reference_accessor.xml:1748 #, no-c-format msgid "" "SELECT ST_XMax('BOX3D(1 2 3, 4 5 6)');\n" @@ -2355,37 +2428,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1684 reference_accessor.xml:1729 +#: reference_accessor.xml:1755 reference_accessor.xml:1800 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:1690 +#: reference_accessor.xml:1761 #, no-c-format msgid "ST_XMin" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1692 +#: reference_accessor.xml:1763 #, no-c-format msgid "Returns X minima of a bounding box 2d or 3d or a geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1697 +#: reference_accessor.xml:1768 #, no-c-format msgid "float ST_XMin box3d aGeomorBox2DorBox3D" msgstr "" #. Tag: para -#: reference_accessor.xml:1707 +#: reference_accessor.xml:1778 #, no-c-format msgid "Returns X minima of a bounding box 2d or 3d or a geometry." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1722 +#: reference_accessor.xml:1793 #, no-c-format msgid "" "SELECT ST_XMin('BOX3D(1 2 3, 4 5 6)');\n" @@ -2414,37 +2487,37 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:1735 +#: reference_accessor.xml:1806 #, no-c-format msgid "ST_Y" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1737 +#: reference_accessor.xml:1808 #, 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:1743 +#: reference_accessor.xml:1814 #, no-c-format msgid "float ST_Y geometry a_point" msgstr "" #. Tag: para -#: reference_accessor.xml:1753 +#: reference_accessor.xml:1824 #, no-c-format msgid "Return the Y coordinate of the point, or NULL if not available. Input must be a point." msgstr "" #. Tag: para -#: reference_accessor.xml:1757 +#: reference_accessor.xml:1828 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 6.1.4" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1765 +#: reference_accessor.xml:1836 #, no-c-format msgid "" "SELECT ST_Y(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n" @@ -2461,37 +2534,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1772 +#: reference_accessor.xml:1843 #, no-c-format msgid ", , , , , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:1778 +#: reference_accessor.xml:1849 #, no-c-format msgid "ST_YMax" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1780 +#: reference_accessor.xml:1851 #, no-c-format msgid "Returns Y maxima of a bounding box 2d or 3d or a geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1785 +#: reference_accessor.xml:1856 #, no-c-format msgid "float ST_YMax box3d aGeomorBox2DorBox3D" msgstr "" #. Tag: para -#: reference_accessor.xml:1795 +#: reference_accessor.xml:1866 #, no-c-format msgid "Returns Y maxima of a bounding box 2d or 3d or a geometry." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1810 +#: reference_accessor.xml:1881 #, no-c-format msgid "" "SELECT ST_YMax('BOX3D(1 2 3, 4 5 6)');\n" @@ -2520,37 +2593,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1817 +#: reference_accessor.xml:1888 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:1823 +#: reference_accessor.xml:1894 #, no-c-format msgid "ST_YMin" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1825 +#: reference_accessor.xml:1896 #, no-c-format msgid "Returns Y minima of a bounding box 2d or 3d or a geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1830 +#: reference_accessor.xml:1901 #, no-c-format msgid "float ST_YMin box3d aGeomorBox2DorBox3D" msgstr "" #. Tag: para -#: reference_accessor.xml:1840 +#: reference_accessor.xml:1911 #, no-c-format msgid "Returns Y minima of a bounding box 2d or 3d or a geometry." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1855 +#: reference_accessor.xml:1926 #, no-c-format msgid "" "SELECT ST_YMin('BOX3D(1 2 3, 4 5 6)');\n" @@ -2579,37 +2652,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1862 +#: reference_accessor.xml:1933 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:1868 +#: reference_accessor.xml:1939 #, no-c-format msgid "ST_Z" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1870 +#: reference_accessor.xml:1941 #, 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:1876 +#: reference_accessor.xml:1947 #, no-c-format msgid "float ST_Z geometry a_point" msgstr "" #. Tag: para -#: reference_accessor.xml:1886 +#: reference_accessor.xml:1957 #, no-c-format msgid "Return the Z coordinate of the point, or NULL if not available. Input must be a point." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1898 +#: reference_accessor.xml:1969 #, no-c-format msgid "" "SELECT ST_Z(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n" @@ -2620,37 +2693,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1905 +#: reference_accessor.xml:1976 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:1911 +#: reference_accessor.xml:1982 #, no-c-format msgid "ST_ZMax" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1913 reference_accessor.xml:2000 +#: reference_accessor.xml:1984 reference_accessor.xml:2071 #, no-c-format msgid "Returns Z minima of a bounding box 2d or 3d or a geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1918 +#: reference_accessor.xml:1989 #, no-c-format msgid "float ST_ZMax box3d aGeomorBox2DorBox3D" msgstr "" #. Tag: para -#: reference_accessor.xml:1928 +#: reference_accessor.xml:1999 #, no-c-format msgid "Returns Z maxima of a bounding box 2d or 3d or a geometry." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1943 +#: reference_accessor.xml:2014 #, no-c-format msgid "" "SELECT ST_ZMax('BOX3D(1 2 3, 4 5 6)');\n" @@ -2679,37 +2752,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1950 +#: reference_accessor.xml:2021 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:1956 +#: reference_accessor.xml:2027 #, no-c-format msgid "ST_Zmflag" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1958 +#: reference_accessor.xml:2029 #, 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:1964 +#: reference_accessor.xml:2035 #, no-c-format msgid "smallint ST_Zmflag geometry geomA" msgstr "" #. Tag: para -#: reference_accessor.xml:1974 +#: reference_accessor.xml:2045 #, 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: programlisting -#: reference_accessor.xml:1985 +#: reference_accessor.xml:2056 #, no-c-format msgid "" "SELECT ST_Zmflag(ST_GeomFromEWKT('LINESTRING(1 2, 3 4)'));\n" @@ -2733,31 +2806,31 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1992 +#: reference_accessor.xml:2063 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_accessor.xml:1998 +#: reference_accessor.xml:2069 #, no-c-format msgid "ST_ZMin" msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:2005 +#: reference_accessor.xml:2076 #, no-c-format msgid "float ST_ZMin box3d aGeomorBox2DorBox3D" msgstr "" #. Tag: para -#: reference_accessor.xml:2015 +#: reference_accessor.xml:2086 #, no-c-format msgid "Returns Z minima of a bounding box 2d or 3d or a geometry." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:2030 +#: reference_accessor.xml:2101 #, no-c-format msgid "" "SELECT ST_ZMin('BOX3D(1 2 3, 4 5 6)');\n" @@ -2786,7 +2859,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:2037 +#: reference_accessor.xml:2108 #, no-c-format msgid ", , , , , , " msgstr "" diff --git a/doc/po/templates/reference_constructor.xml.pot b/doc/po/templates/reference_constructor.xml.pot index 69185e289..26aacc4c3 100644 --- a/doc/po/templates/reference_constructor.xml.pot +++ b/doc/po/templates/reference_constructor.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -39,7 +39,7 @@ msgid "geometry ST_BdPolyFromText precision is specified ST_Box2dFromGeoHash will use msgstr "" #. Tag: para -#: reference_constructor.xml:131 reference_constructor.xml:446 reference_constructor.xml:1705 +#: reference_constructor.xml:131 reference_constructor.xml:482 reference_constructor.xml:1698 #, no-c-format msgid "Availability: 2.1.0" msgstr "" @@ -220,7 +220,7 @@ msgstr "" #. Tag: para #: reference_constructor.xml:160 #, no-c-format -msgid "Returns a geography object from the well-known text or extended well-known representation. SRID 4326 is assumed. This is an alias for ST_GeographyFromText. Points are always expressed in long lat form." +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: programlisting @@ -229,7 +229,10 @@ msgstr "" 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 || ')');" + "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 @@ -253,7 +256,7 @@ msgstr "" #. Tag: para #: reference_constructor.xml:189 #, no-c-format -msgid "Returns a geography object from the well-known text representation. SRID 4326 is assumed." +msgid "Returns a geography object from the well-known text representation. SRID 4326 is assumed if unspecified." msgstr "" #. Tag: para @@ -277,7 +280,7 @@ msgstr "" #. Tag: funcprototype #: reference_constructor.xml:207 #, no-c-format -msgid "geography ST_GeogFromWKB bytea geom" +msgid "geography ST_GeogFromWKB bytea wkb" msgstr "" #. Tag: para @@ -293,7 +296,7 @@ msgid "If SRID is not specified, it defaults to 4326 (WGS 84 long lat)." msgstr "" #. Tag: para -#: reference_constructor.xml:224 reference_constructor.xml:326 reference_constructor.xml:374 reference_constructor.xml:691 reference_constructor.xml:741 reference_constructor.xml:1810 +#: reference_constructor.xml:224 reference_constructor.xml:362 reference_constructor.xml:410 reference_constructor.xml:727 reference_constructor.xml:777 reference_constructor.xml:1803 #, no-c-format msgid "&curve_support;" msgstr "" @@ -319,133 +322,178 @@ msgid ", " msgstr "" #. Tag: refname +#: reference_constructor.xml:243 +#, no-c-format +msgid "ST_GeomFromTWKB" +msgstr "" + +#. Tag: refpurpose #: reference_constructor.xml:244 #, no-c-format +msgid "Creates a geometry instance from a TWKB (\"Tiny Well-Known Binary\") geometry representation." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:250 +#, no-c-format +msgid "geometry ST_GeomFromTWKB bytea twkb" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:260 +#, 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_constructor.xml:269 +#, 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_constructor.xml:280 +#, no-c-format msgid "ST_GeomCollFromText" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:246 +#: reference_constructor.xml:282 #, no-c-format msgid "Makes a collection Geometry from collection WKT with the given SRID. If SRID is not give, it defaults to 0." msgstr "" #. Tag: funcsynopsis -#: reference_constructor.xml:251 +#: reference_constructor.xml:287 #, no-c-format msgid " geometry ST_GeomCollFromText text WKT integer srid geometry ST_GeomCollFromText text WKT " msgstr "" #. Tag: para -#: reference_constructor.xml:269 +#: reference_constructor.xml:305 #, no-c-format msgid "Makes a collection Geometry from the Well-Known-Text (WKT) representation with the given SRID. If SRID is not give, it defaults to 0." msgstr "" #. Tag: para -#: reference_constructor.xml:272 reference_constructor.xml:1475 reference_constructor.xml:1536 reference_constructor.xml:1597 reference_constructor.xml:1905 +#: reference_constructor.xml:308 reference_constructor.xml:1468 reference_constructor.xml:1529 reference_constructor.xml:1590 reference_constructor.xml:1898 #, no-c-format msgid "OGC SPEC 3.2.6.2 - option SRID is from the conformance suite" msgstr "" #. Tag: para -#: reference_constructor.xml:274 +#: reference_constructor.xml:310 #, no-c-format msgid "Returns null if the WKT is not a GEOMETRYCOLLECTION" msgstr "" #. Tag: para -#: reference_constructor.xml:276 +#: reference_constructor.xml:312 #, no-c-format msgid "If you are absolutely sure all your WKT geometries are collections, don't use this function. It is slower than ST_GeomFromText since it adds an additional validation step." msgstr "" #. Tag: para -#: reference_constructor.xml:282 +#: reference_constructor.xml:318 #, no-c-format msgid "&sqlmm_compliant;" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:290 +#: reference_constructor.xml:326 #, no-c-format msgid "SELECT ST_GeomCollFromText('GEOMETRYCOLLECTION(POINT(1 2),LINESTRING(1 2, 3 4))');" msgstr "" #. Tag: para -#: reference_constructor.xml:297 reference_constructor.xml:1624 +#: reference_constructor.xml:333 reference_constructor.xml:1617 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_constructor.xml:304 +#: reference_constructor.xml:340 #, no-c-format msgid "ST_GeomFromEWKB" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:305 +#: reference_constructor.xml:341 #, no-c-format msgid "Return a specified ST_Geometry value from Extended Well-Known Binary representation (EWKB)." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:310 +#: reference_constructor.xml:346 #, no-c-format msgid "geometry ST_GeomFromEWKB bytea EWKB" msgstr "" #. Tag: para -#: reference_constructor.xml:319 +#: reference_constructor.xml:355 #, no-c-format msgid "Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known binary (EWKT) representation." msgstr "" #. Tag: para -#: reference_constructor.xml:321 +#: reference_constructor.xml:357 #, no-c-format msgid "The EWKB format is not an OGC standard, but a PostGIS specific format that includes the spatial reference system (SRID) identifier" msgstr "" #. Tag: para -#: reference_constructor.xml:324 reference_constructor.xml:372 reference_constructor.xml:501 reference_constructor.xml:648 +#: reference_constructor.xml:360 reference_constructor.xml:408 reference_constructor.xml:537 reference_constructor.xml:684 #, no-c-format msgid "Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced." msgstr "" #. Tag: para -#: reference_constructor.xml:325 reference_constructor.xml:373 reference_constructor.xml:503 reference_constructor.xml:562 reference_constructor.xml:608 reference_constructor.xml:863 reference_constructor.xml:1199 reference_constructor.xml:1316 reference_constructor.xml:1395 reference_constructor.xml:1809 reference_constructor.xml:1857 +#: reference_constructor.xml:361 reference_constructor.xml:409 reference_constructor.xml:539 reference_constructor.xml:598 reference_constructor.xml:644 reference_constructor.xml:855 reference_constructor.xml:1191 reference_constructor.xml:1308 reference_constructor.xml:1388 reference_constructor.xml:1802 reference_constructor.xml:1850 #, no-c-format msgid "&Z_support;" msgstr "" #. Tag: para -#: reference_constructor.xml:327 reference_constructor.xml:375 reference_constructor.xml:504 +#: reference_constructor.xml:363 reference_constructor.xml:411 reference_constructor.xml:540 #, no-c-format msgid "&P_support;" msgstr "" #. Tag: para -#: reference_constructor.xml:328 reference_constructor.xml:376 reference_constructor.xml:505 +#: reference_constructor.xml:364 reference_constructor.xml:412 reference_constructor.xml:541 #, no-c-format msgid "&T_support;" msgstr "" #. Tag: para -#: reference_constructor.xml:333 +#: reference_constructor.xml:369 #, 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_constructor.xml:335 +#: reference_constructor.xml:371 #, no-c-format msgid "NOTE: Even though byte arrays are delimited with \\ and may have ', we need to escape both out with \\ and '' if standard_conforming_strings is off. So it does not look exactly like its AsEWKB representation." msgstr "" #. Tag: programlisting -#: reference_constructor.xml:337 +#: reference_constructor.xml:373 #, no-c-format msgid "" "SELECT ST_GeomFromEWKB(E'\\\\001\\\\002\\\\000\\\\000 \\\\255\\\\020\\\\000\\\\000\\\\003\\\\000\\\\000\\\\000\\\\344J=\n" @@ -455,13 +503,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:339 +#: reference_constructor.xml:375 #, no-c-format msgid "In PostgreSQL 9.1+ - standard_conforming_strings is set to on by default, where as in past versions it was set to on. You can change defaults as needed for a single query or at the database or server level. Below is how you would do it with standard_conforming_strings = on. In this case we escape the ' with standard ansi ', but slashes are not escaped" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:342 +#: reference_constructor.xml:378 #, no-c-format msgid "" "set standard_conforming_strings = on;\n" @@ -470,43 +518,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:346 +#: reference_constructor.xml:382 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_constructor.xml:352 +#: reference_constructor.xml:388 #, no-c-format msgid "ST_GeomFromEWKT" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:353 +#: reference_constructor.xml:389 #, no-c-format msgid "Return a specified ST_Geometry value from Extended Well-Known Text representation (EWKT)." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:358 +#: reference_constructor.xml:394 #, no-c-format msgid "geometry ST_GeomFromEWKT text EWKT" msgstr "" #. Tag: para -#: reference_constructor.xml:367 +#: reference_constructor.xml:403 #, no-c-format msgid "Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known text (EWKT) representation." msgstr "" #. Tag: para -#: reference_constructor.xml:369 +#: reference_constructor.xml:405 #, no-c-format msgid "The EWKT format is not an OGC standard, but an PostGIS specific format that includes the spatial reference system (SRID) identifier" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:381 +#: reference_constructor.xml:417 #, no-c-format msgid "" "SELECT ST_GeomFromEWKT('SRID=4269;LINESTRING(-71.160281 42.258729,-71.160837 42.259113,-71.161144 42.25932)');\n" @@ -543,7 +591,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:382 +#: reference_constructor.xml:418 #, no-c-format msgid "" "--3d circular string\n" @@ -551,7 +599,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:383 +#: reference_constructor.xml:419 #, no-c-format msgid "" "--Polyhedral Surface example\n" @@ -566,79 +614,79 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:387 +#: reference_constructor.xml:423 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_constructor.xml:392 +#: reference_constructor.xml:428 #, no-c-format msgid "ST_GeometryFromText" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:393 reference_constructor.xml:1954 +#: reference_constructor.xml:429 reference_constructor.xml:1947 #, no-c-format msgid "Return a specified ST_Geometry value from Well-Known Text representation (WKT). This is an alias name for ST_GeomFromText" msgstr "" #. Tag: funcsynopsis -#: reference_constructor.xml:396 +#: reference_constructor.xml:432 #, no-c-format msgid " geometry ST_GeometryFromText text WKT geometry ST_GeometryFromText text WKT integer srid " msgstr "" #. Tag: para -#: reference_constructor.xml:410 reference_constructor.xml:1855 +#: reference_constructor.xml:446 reference_constructor.xml:1848 #, no-c-format msgid "&sfs_compliant;" msgstr "" #. Tag: para -#: reference_constructor.xml:411 reference_constructor.xml:690 +#: reference_constructor.xml:447 reference_constructor.xml:726 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.40" msgstr "" #. Tag: refname -#: reference_constructor.xml:422 +#: reference_constructor.xml:458 #, no-c-format msgid "ST_GeomFromGeoHash" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:424 +#: reference_constructor.xml:460 #, no-c-format msgid "Return a geometry from a GeoHash string." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:429 +#: reference_constructor.xml:465 #, no-c-format msgid "geometry ST_GeomFromGeoHash text geohash integer precision=full_precision_of_geohash" msgstr "" #. Tag: para -#: reference_constructor.xml:440 +#: reference_constructor.xml:476 #, 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_constructor.xml:442 +#: reference_constructor.xml:478 #, no-c-format msgid "If no precision is specficified ST_GeomFromGeoHash returns a polygon based on full precision of the input GeoHash string." msgstr "" #. Tag: para -#: reference_constructor.xml:444 +#: reference_constructor.xml:480 #, 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_constructor.xml:451 +#: reference_constructor.xml:487 #, no-c-format msgid "" ", " msgstr "" #. Tag: refname -#: reference_constructor.xml:462 +#: reference_constructor.xml:498 #, no-c-format msgid "ST_GeomFromGML" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:463 +#: 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:467 +#: 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:482 +#: 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:483 +#: 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:484 +#: 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:500 reference_constructor.xml:647 +#: reference_constructor.xml:536 reference_constructor.xml:683 #, no-c-format msgid "Availability: 1.5, requires libxml2 1.6+" msgstr "" #. Tag: para -#: reference_constructor.xml:502 reference_constructor.xml:649 +#: reference_constructor.xml:538 reference_constructor.xml:685 #, no-c-format msgid "Enhanced: 2.0.0 default srid optional parameter added." msgstr "" #. Tag: para -#: reference_constructor.xml:506 +#: 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:508 +#: 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:510 +#: 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:512 +#: reference_constructor.xml:548 #, no-c-format msgid "ST_GeomFromGML function not support SQL/MM curves geometries." msgstr "" #. Tag: title -#: reference_constructor.xml:518 reference_constructor.xml:616 +#: reference_constructor.xml:554 reference_constructor.xml:652 #, no-c-format msgid "Examples - A single geometry with srsName" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:519 +#: reference_constructor.xml:555 #, no-c-format msgid "" "SELECT ST_GeomFromGML(', " msgstr "" #. Tag: refname -#: reference_constructor.xml:541 +#: reference_constructor.xml:577 #, no-c-format msgid "ST_GeomFromGeoJSON" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:542 +#: 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: funcprototype -#: reference_constructor.xml:547 +#: reference_constructor.xml:583 #, no-c-format msgid "geometry ST_GeomFromGeoJSON text geomjson" msgstr "" #. Tag: para -#: reference_constructor.xml:556 +#: reference_constructor.xml:592 #, no-c-format msgid "Constructs a PostGIS geometry object from the GeoJSON representation." msgstr "" #. Tag: para -#: reference_constructor.xml:557 +#: reference_constructor.xml:593 #, 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:559 +#: reference_constructor.xml:595 #, no-c-format msgid "Availability: 2.0.0 requires - JSON-C >= 0.9" msgstr "" #. Tag: para -#: reference_constructor.xml:560 +#: reference_constructor.xml:596 #, 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:567 +#: reference_constructor.xml:603 #, no-c-format msgid "" "SELECT ST_AsText(ST_GeomFromGeoJSON('{\"type\":\"Point\",\"coordinates\":[-48.23456,20.12345]}')) As wkt;\n" @@ -892,7 +940,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:568 +#: reference_constructor.xml:604 #, no-c-format msgid "" "-- a 3D linestring\n" @@ -904,61 +952,61 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:574 +#: reference_constructor.xml:610 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_constructor.xml:580 +#: reference_constructor.xml:616 #, no-c-format msgid "ST_GeomFromKML" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:581 +#: reference_constructor.xml:617 #, no-c-format msgid "Takes as input KML representation of geometry and outputs a PostGIS geometry object" msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:586 +#: reference_constructor.xml:622 #, no-c-format msgid "geometry ST_GeomFromKML text geomkml" msgstr "" #. Tag: para -#: reference_constructor.xml:595 +#: reference_constructor.xml:631 #, no-c-format msgid "Constructs a PostGIS ST_Geometry object from the OGC KML representation." msgstr "" #. Tag: para -#: reference_constructor.xml:596 +#: reference_constructor.xml:632 #, 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:597 +#: reference_constructor.xml:633 #, 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:607 +#: reference_constructor.xml:643 #, no-c-format msgid "Availability: 1.5,libxml2 2.6+" msgstr "" #. Tag: para -#: reference_constructor.xml:610 +#: reference_constructor.xml:646 #, no-c-format msgid "ST_GeomFromKML function not support SQL/MM curves geometries." msgstr "" #. Tag: programlisting -#: reference_constructor.xml:617 +#: reference_constructor.xml:653 #, no-c-format msgid "" "SELECT ST_GeomFromKML('" msgstr "" #. Tag: refname -#: reference_constructor.xml:628 +#: reference_constructor.xml:664 #, no-c-format msgid "ST_GMLToSQL" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:629 +#: reference_constructor.xml:665 #, 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:632 +#: reference_constructor.xml:668 #, no-c-format msgid " geometry ST_GMLToSQL text geomgml geometry ST_GMLToSQL text geomgml integer srid " msgstr "" #. Tag: para -#: reference_constructor.xml:646 +#: reference_constructor.xml:682 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.50 (except for curves support)." msgstr "" #. Tag: para -#: reference_constructor.xml:653 +#: reference_constructor.xml:689 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_constructor.xml:659 +#: reference_constructor.xml:695 #, no-c-format msgid "ST_GeomFromText" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:660 +#: reference_constructor.xml:696 #, no-c-format msgid "Return a specified ST_Geometry value from Well-Known Text representation (WKT)." msgstr "" #. Tag: funcsynopsis -#: reference_constructor.xml:663 +#: reference_constructor.xml:699 #, no-c-format msgid " geometry ST_GeomFromText text WKT geometry ST_GeomFromText text WKT integer srid " msgstr "" #. Tag: para -#: reference_constructor.xml:679 +#: reference_constructor.xml:715 #, no-c-format msgid "Constructs a PostGIS ST_Geometry object from the OGC Well-Known text representation." msgstr "" #. Tag: para -#: reference_constructor.xml:683 +#: reference_constructor.xml:719 #, no-c-format msgid "There are 2 variants of ST_GeomFromText function, the first takes no SRID and returns a geometry with no defined spatial reference system. The second takes a spatial reference id as the second argument and returns an ST_Geometry that includes this srid as part of its meta-data. The srid must be defined in the spatial_ref_sys table." msgstr "" #. Tag: para -#: reference_constructor.xml:689 reference_constructor.xml:1759 +#: reference_constructor.xml:725 reference_constructor.xml:1752 #, no-c-format msgid "&sfs_compliant; s3.2.6.2 - option SRID is from the conformance suite." msgstr "" #. Tag: para -#: reference_constructor.xml:692 +#: reference_constructor.xml:728 #, 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:699 +#: reference_constructor.xml:735 #, no-c-format msgid "" "SELECT ST_GeomFromText('LINESTRING(-71.160281 42.258729,-71.160837 42.259113,-71.161144 42.25932)');\n" @@ -1088,55 +1136,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:703 +#: reference_constructor.xml:739 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_constructor.xml:709 +#: reference_constructor.xml:745 #, no-c-format msgid "ST_GeomFromWKB" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:710 +#: reference_constructor.xml:746 #, 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:715 reference_constructor.xml:1781 +#: reference_constructor.xml:751 reference_constructor.xml:1774 #, no-c-format msgid " geometry ST_GeomFromWKB bytea geom geometry ST_GeomFromWKB bytea geom integer srid " msgstr "" #. Tag: para -#: reference_constructor.xml:732 +#: reference_constructor.xml:768 #, 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:738 +#: reference_constructor.xml:774 #, no-c-format msgid "If SRID is not specified, it defaults to 0 (Unknown)." msgstr "" #. Tag: para -#: reference_constructor.xml:739 +#: reference_constructor.xml:775 #, no-c-format msgid "&sfs_compliant; s3.2.7.2 - the optional SRID is from the conformance suite" msgstr "" #. Tag: para -#: reference_constructor.xml:740 +#: reference_constructor.xml:776 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.41" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:748 +#: reference_constructor.xml:784 #, no-c-format msgid "" "--Although bytea rep contains single \\, these need to be escaped when inserting into a table \n" @@ -1162,111 +1210,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:755 +#: reference_constructor.xml:791 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_constructor.xml:762 -#, no-c-format -msgid "ST_GeomFromTWKB" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:763 -#, no-c-format -msgid "Creates a geometry instance from a Tiny Well-Known Binary geometry representation (TWKB)." -msgstr "" - -#. Tag: funcprototype -#: reference_constructor.xml:769 -#, no-c-format -msgid "geometry ST_GeomFromTWKB bytea geom" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:779 -#, no-c-format -msgid "The ST_GeomFromTWKB function, takes a tiny well-known binary representation of a geometry and creates an instance of the appropriate geometry type." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:783 -#, no-c-format -msgid "SRID always defaults to 0 (Unknown)." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:785 -#, no-c-format -msgid "TWKB doesn't make any difference of Z and M. So a 3D geoemtry in TWKB will always be a GeometryZ, like PointZ when converted to PostGIS geometry" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:793 -#, 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_GeomFromTWKB(E'\\\\x304202f7f40dbce4040105')\n" - ");\n" - " st_asewkt\n" - "------------------------------------------------------\n" - "LINESTRING(-113.98 39.198,-113.981 39.195)\n" - "(1 row)\n" - "\n" - "SELECT\n" - " ST_AsText(\n" - " ST_GeomFromTWKB(\n" - " ST_AsTWKB('POINT(2 5)'::geometry,0)\n" - " )\n" - " );\n" - " st_astext\n" - "------------\n" - " POINT(2 5)\n" - "(1 row)" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:800 -#, no-c-format -msgid ",,,, , " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:806 +#: reference_constructor.xml:798 #, no-c-format msgid "ST_LineFromEncodedPolyline" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:808 +#: reference_constructor.xml:800 #, no-c-format msgid "Creates a LineString from an Encoded Polyline." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:813 +#: reference_constructor.xml:805 #, no-c-format msgid "geometry ST_LineFromEncodedPolyline text polyline integer precision=5" msgstr "" #. Tag: para -#: reference_constructor.xml:824 +#: reference_constructor.xml:816 #, no-c-format msgid "Creates a LineString from an Encoded Polyline string." msgstr "" #. Tag: para -#: reference_constructor.xml:825 +#: reference_constructor.xml:817 #, no-c-format msgid "See http://developers.google.com/maps/documentation/utilities/polylinealgorithm" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:832 +#: reference_constructor.xml:824 #, no-c-format msgid "" "--Create a line string from a polyline\n" @@ -1276,31 +1256,31 @@ msgid "" msgstr "" #. Tag: refname -#: reference_constructor.xml:845 +#: reference_constructor.xml:837 #, no-c-format msgid "ST_LineFromMultiPoint" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:847 +#: reference_constructor.xml:839 #, no-c-format msgid "Creates a LineString from a MultiPoint geometry." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:852 +#: reference_constructor.xml:844 #, no-c-format msgid "geometry ST_LineFromMultiPoint geometry aMultiPoint" msgstr "" #. Tag: para -#: reference_constructor.xml:862 +#: reference_constructor.xml:854 #, no-c-format msgid "Creates a LineString from a MultiPoint geometry." msgstr "" #. Tag: programlisting -#: reference_constructor.xml:870 +#: reference_constructor.xml:862 #, no-c-format msgid "" "--Create a 3d line string from a 3d multipoint\n" @@ -1310,55 +1290,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:877 +#: reference_constructor.xml:869 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_constructor.xml:883 +#: reference_constructor.xml:875 #, no-c-format msgid "ST_LineFromText" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:885 +#: reference_constructor.xml:877 #, 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:890 +#: reference_constructor.xml:882 #, no-c-format msgid " geometry ST_LineFromText text WKT geometry ST_LineFromText text WKT integer srid " msgstr "" #. Tag: para -#: reference_constructor.xml:907 +#: reference_constructor.xml:899 #, no-c-format msgid "Makes a Geometry from WKT with the given SRID. If SRID is not give, it defaults to 0. If WKT passed in is not a LINESTRING, then null is returned." msgstr "" #. Tag: para -#: reference_constructor.xml:911 reference_constructor.xml:977 +#: reference_constructor.xml:903 reference_constructor.xml:969 #, no-c-format msgid "OGC SPEC 3.2.6.2 - option SRID is from the conformance suite." msgstr "" #. Tag: para -#: reference_constructor.xml:916 +#: reference_constructor.xml:908 #, 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:922 +#: reference_constructor.xml:914 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 7.2.8" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:930 +#: reference_constructor.xml:922 #, no-c-format msgid "" "SELECT ST_LineFromText('LINESTRING(1 2, 3 4)') AS aline, ST_LineFromText('POINT(1 2)') AS null_return;\n" @@ -1368,49 +1348,49 @@ msgid "" msgstr "" #. Tag: refname -#: reference_constructor.xml:943 +#: reference_constructor.xml:935 #, no-c-format msgid "ST_LineFromWKB" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:945 +#: reference_constructor.xml:937 #, no-c-format msgid "Makes a LINESTRING from WKB with the given SRID" msgstr "" #. Tag: funcsynopsis -#: reference_constructor.xml:949 +#: reference_constructor.xml:941 #, no-c-format msgid " geometry ST_LineFromWKB bytea WKB geometry ST_LineFromWKB bytea WKB integer srid " msgstr "" #. Tag: para -#: reference_constructor.xml:966 +#: reference_constructor.xml:958 #, 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:972 +#: reference_constructor.xml:964 #, 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:982 +#: reference_constructor.xml:974 #, 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:990 reference_constructor.xml:1056 +#: reference_constructor.xml:982 reference_constructor.xml:1048 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 7.2.9" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:998 +#: reference_constructor.xml:990 #, no-c-format msgid "" "SELECT ST_LineFromWKB(ST_AsBinary(ST_GeomFromText('LINESTRING(1 2, 3 4)'))) AS aline,\n" @@ -1421,55 +1401,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:1005 +#: reference_constructor.xml:997 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_constructor.xml:1011 +#: reference_constructor.xml:1003 #, no-c-format msgid "ST_LinestringFromWKB" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1013 +#: reference_constructor.xml:1005 #, no-c-format msgid "Makes a geometry from WKB with the given SRID." msgstr "" #. Tag: funcsynopsis -#: reference_constructor.xml:1017 +#: reference_constructor.xml:1009 #, no-c-format msgid " geometry ST_LinestringFromWKB bytea WKB geometry ST_LinestringFromWKB bytea WKB integer srid " msgstr "" #. Tag: para -#: reference_constructor.xml:1034 +#: reference_constructor.xml:1026 #, 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:1040 +#: reference_constructor.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 LINESTRING geometry. This an alias for ." msgstr "" #. Tag: para -#: reference_constructor.xml:1045 +#: reference_constructor.xml:1037 #, no-c-format msgid "OGC SPEC 3.2.6.2 - optional SRID is from the conformance suite." msgstr "" #. Tag: para -#: reference_constructor.xml:1049 +#: reference_constructor.xml:1041 #, 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:1062 +#: reference_constructor.xml:1054 #, no-c-format msgid "" "SELECT\n" @@ -1485,37 +1465,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:1069 reference_constructor.xml:1823 +#: reference_constructor.xml:1061 reference_constructor.xml:1816 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_constructor.xml:1075 +#: reference_constructor.xml:1067 #, no-c-format msgid "ST_MakeBox2D" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1077 +#: reference_constructor.xml:1069 #, no-c-format msgid "Creates a BOX2D defined by the given point geometries." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:1083 +#: reference_constructor.xml:1075 #, no-c-format msgid "box2d ST_MakeBox2D geometry pointLowLeft geometry pointUpRight" msgstr "" #. Tag: para -#: reference_constructor.xml:1094 +#: reference_constructor.xml:1086 #, 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:1102 +#: reference_constructor.xml:1094 #, no-c-format msgid "" "--Return all features that fall reside or partly reside in a US national atlas coordinate bounding box\n" @@ -1527,49 +1507,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:1109 +#: reference_constructor.xml:1101 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_constructor.xml:1115 +#: reference_constructor.xml:1107 #, no-c-format msgid "ST_3DMakeBox" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1117 +#: reference_constructor.xml:1109 #, no-c-format msgid "Creates a BOX3D defined by the given 3d point geometries." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:1122 +#: reference_constructor.xml:1114 #, no-c-format msgid "box3d ST_3DMakeBox geometry point3DLowLeftBottom geometry point3DUpRightTop" msgstr "" #. Tag: para -#: reference_constructor.xml:1133 +#: reference_constructor.xml:1125 #, no-c-format msgid "Creates a BOX3D defined by the given 2 3D point geometries." msgstr "" #. Tag: para -#: reference_constructor.xml:1140 +#: reference_constructor.xml:1132 #, no-c-format msgid "This function supports 3d and will not drop the z-index." msgstr "" #. Tag: para -#: reference_constructor.xml:1142 +#: reference_constructor.xml:1134 #, no-c-format msgid "Changed: 2.0.0 In prior versions this used to be called ST_MakeBox3D" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1149 +#: reference_constructor.xml:1141 #, no-c-format msgid "" "SELECT ST_3DMakeBox(ST_MakePoint(-989502.1875, 528439.5625, 10),\n" @@ -1581,67 +1561,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:1156 +#: reference_constructor.xml:1148 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_constructor.xml:1162 +#: reference_constructor.xml:1154 #, no-c-format msgid "ST_MakeLine" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1164 +#: reference_constructor.xml:1156 #, no-c-format msgid "Creates a Linestring from point or line geometries." msgstr "" #. Tag: funcsynopsis -#: reference_constructor.xml:1168 +#: reference_constructor.xml:1160 #, 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:1190 +#: reference_constructor.xml:1182 #, no-c-format msgid "ST_MakeLine comes in 3 forms: a spatial aggregate that takes rows of point-or-line geometries and returns a line string, a function that takes an array of point-or-lines, and a regular function that takes two point-or-line geometries. You might want to use a subselect to order points before feeding them to the aggregate version of this function." msgstr "" #. Tag: para -#: reference_constructor.xml:1195 +#: reference_constructor.xml:1187 #, no-c-format msgid "When adding line components a common node is removed from the output." msgstr "" #. Tag: para -#: reference_constructor.xml:1200 +#: reference_constructor.xml:1192 #, no-c-format msgid "Availability: 1.4.0 - ST_MakeLine(geomarray) was introduced. ST_MakeLine aggregate functions was enhanced to handle more points faster." msgstr "" #. Tag: para -#: reference_constructor.xml:1201 +#: reference_constructor.xml:1193 #, no-c-format msgid "Availability: 2.0.0 - Support for linestring input elements was introduced" msgstr "" #. Tag: title -#: reference_constructor.xml:1205 +#: reference_constructor.xml:1197 #, no-c-format msgid "Examples: Spatial Aggregate version" msgstr "" #. Tag: para -#: reference_constructor.xml:1206 +#: reference_constructor.xml:1198 #, 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:1210 +#: reference_constructor.xml:1202 #, no-c-format msgid "" "-- For pre-PostgreSQL 9.0 - this usually works, \n" @@ -1653,7 +1633,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1212 +#: reference_constructor.xml:1204 #, no-c-format msgid "" "-- If you are using PostgreSQL 9.0+ \n" @@ -1666,19 +1646,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_constructor.xml:1215 +#: reference_constructor.xml:1207 #, no-c-format msgid "Examples: Non-Spatial Aggregate version" msgstr "" #. Tag: para -#: reference_constructor.xml:1217 +#: reference_constructor.xml:1209 #, 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:1219 +#: reference_constructor.xml:1211 #, no-c-format msgid "" "SELECT ST_AsText(ST_MakeLine(ST_MakePoint(1,2), ST_MakePoint(3,4)));\n" @@ -1696,13 +1676,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_constructor.xml:1223 +#: reference_constructor.xml:1215 #, no-c-format msgid "Examples: Using Array version" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1225 +#: reference_constructor.xml:1217 #, no-c-format msgid "" "SELECT ST_MakeLine(ARRAY(SELECT ST_Centroid(the_geom) FROM visit_locations ORDER BY visit_time));\n" @@ -1716,55 +1696,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:1232 +#: reference_constructor.xml:1224 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_constructor.xml:1239 +#: reference_constructor.xml:1231 #, no-c-format msgid "ST_MakeEnvelope" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1241 +#: reference_constructor.xml:1233 #, 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:1247 +#: reference_constructor.xml:1239 #, 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:1261 +#: reference_constructor.xml:1253 #, 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:1264 +#: reference_constructor.xml:1256 #, no-c-format msgid "Availability: 1.5" msgstr "" #. Tag: para -#: reference_constructor.xml:1265 +#: reference_constructor.xml:1257 #, no-c-format msgid "Enhanced: 2.0: Ability to specify an envelope without specifying an SRID was introduced." msgstr "" #. Tag: title -#: reference_constructor.xml:1270 +#: reference_constructor.xml:1262 #, no-c-format msgid "Example: Building a bounding box polygon" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1271 +#: reference_constructor.xml:1263 #, no-c-format msgid "" "SELECT ST_AsText(ST_MakeEnvelope(10, 10, 11, 11, 4326));\n" @@ -1775,67 +1755,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:1275 +#: reference_constructor.xml:1267 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_constructor.xml:1281 +#: reference_constructor.xml:1273 #, no-c-format msgid "ST_MakePolygon" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1283 +#: reference_constructor.xml:1275 #, no-c-format msgid "Creates a Polygon formed by the given shell. Input geometries must be closed LINESTRINGS." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:1289 +#: reference_constructor.xml:1281 #, no-c-format msgid "geometry ST_MakePolygon geometry linestring" msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:1295 +#: reference_constructor.xml:1287 #, no-c-format msgid "geometry ST_MakePolygon geometry outerlinestring geometry[] interiorlinestrings" msgstr "" #. Tag: para -#: reference_constructor.xml:1306 +#: reference_constructor.xml:1298 #, 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:1308 +#: reference_constructor.xml:1300 #, no-c-format msgid "Variant 1: takes one closed linestring." msgstr "" #. Tag: para -#: reference_constructor.xml:1309 +#: reference_constructor.xml:1301 #, 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:1313 +#: reference_constructor.xml:1305 #, no-c-format msgid "This function will not accept a MULTILINESTRING. Use or to generate line strings." msgstr "" #. Tag: title -#: reference_constructor.xml:1320 +#: reference_constructor.xml:1312 #, no-c-format msgid "Examples: Single closed LINESTRING" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1321 +#: reference_constructor.xml:1313 #, no-c-format msgid "" "--2d line\n" @@ -1862,19 +1842,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_constructor.xml:1324 +#: reference_constructor.xml:1316 #, no-c-format msgid "Examples: Outter shell with inner shells" msgstr "" #. Tag: para -#: reference_constructor.xml:1326 +#: reference_constructor.xml:1318 #, no-c-format msgid "Build a donut with an ant hole" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1327 +#: reference_constructor.xml:1319 #, no-c-format msgid "" "SELECT ST_MakePolygon(\n" @@ -1889,25 +1869,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:1328 +#: reference_constructor.xml:1320 #, no-c-format msgid "Build province boundaries with holes representing lakes in the province from a set of province polygons/multipolygons and water line strings this is an example of using PostGIS ST_Accum" msgstr "" #. Tag: para -#: reference_constructor.xml:1332 +#: reference_constructor.xml:1324 #, no-c-format msgid "The use of CASE because feeding a null array into ST_MakePolygon results in NULL" msgstr "" #. Tag: para -#: reference_constructor.xml:1334 +#: reference_constructor.xml:1326 #, no-c-format msgid "the use of left join to guarantee we get all provinces back even if they have no lakes" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1335 +#: reference_constructor.xml:1327 #, no-c-format msgid "" "SELECT p.gid, p.province_name,\n" @@ -1939,61 +1919,61 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:1339 +#: reference_constructor.xml:1331 #, no-c-format -msgid ", , , , , " +msgid ", , , , , , " msgstr "" #. Tag: refname -#: reference_constructor.xml:1352 +#: reference_constructor.xml:1345 #, no-c-format msgid "ST_MakePoint" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1354 +#: reference_constructor.xml:1347 #, no-c-format msgid "Creates a 2D,3DZ or 4D point geometry." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:1359 +#: reference_constructor.xml:1352 #, no-c-format msgid "geometry ST_MakePoint double precision x double precision y" msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:1366 +#: reference_constructor.xml:1359 #, no-c-format msgid "geometry ST_MakePoint double precision x double precision y double precision z" msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:1374 +#: reference_constructor.xml:1367 #, 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:1387 +#: reference_constructor.xml:1380 #, 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:1393 +#: reference_constructor.xml:1386 #, no-c-format msgid "Note x is longitude and y is latitude" msgstr "" #. Tag: para -#: reference_constructor.xml:1394 +#: reference_constructor.xml:1387 #, no-c-format msgid "Use if you need to make a point with x,y,m." msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1401 +#: reference_constructor.xml:1394 #, no-c-format msgid "" "--Return point with unknown SRID\n" @@ -2013,49 +1993,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:1405 +#: reference_constructor.xml:1398 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_constructor.xml:1411 +#: reference_constructor.xml:1404 #, no-c-format msgid "ST_MakePointM" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1413 +#: reference_constructor.xml:1406 #, no-c-format msgid "Creates a point geometry with an x y and m coordinate." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:1418 +#: reference_constructor.xml:1411 #, no-c-format msgid "geometry ST_MakePointM float x float y float m" msgstr "" #. Tag: para -#: reference_constructor.xml:1430 +#: reference_constructor.xml:1423 #, no-c-format msgid "Creates a point with x, y and measure coordinates." msgstr "" #. Tag: para -#: reference_constructor.xml:1431 +#: reference_constructor.xml:1424 #, no-c-format msgid "Note x is longitude and y is latitude." msgstr "" #. Tag: para -#: reference_constructor.xml:1436 +#: reference_constructor.xml:1429 #, 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:1438 +#: reference_constructor.xml:1431 #, no-c-format msgid "" "--Return EWKT representation of point with unknown SRID\n" @@ -2084,103 +2064,103 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:1442 +#: reference_constructor.xml:1435 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_constructor.xml:1448 +#: reference_constructor.xml:1441 #, no-c-format msgid "ST_MLineFromText" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1450 +#: reference_constructor.xml:1443 #, no-c-format msgid "Return a specified ST_MultiLineString value from WKT representation." msgstr "" #. Tag: funcsynopsis -#: reference_constructor.xml:1454 +#: reference_constructor.xml:1447 #, no-c-format msgid " geometry ST_MLineFromText text WKT integer srid geometry ST_MLineFromText text WKT " msgstr "" #. Tag: para -#: reference_constructor.xml:1472 +#: reference_constructor.xml:1465 #, no-c-format msgid "Makes a Geometry from Well-Known-Text (WKT) with the given SRID. If SRID is not give, it defaults to 0." msgstr "" #. Tag: para -#: reference_constructor.xml:1478 +#: reference_constructor.xml:1471 #, no-c-format msgid "Returns null if the WKT is not a MULTILINESTRING" msgstr "" #. Tag: para -#: reference_constructor.xml:1481 reference_constructor.xml:1542 +#: reference_constructor.xml:1474 reference_constructor.xml:1535 #, no-c-format msgid "If you are absolutely sure all your WKT geometries are points, don't use this function. It is slower than ST_GeomFromText since it adds an additional validation step." msgstr "" #. Tag: para -#: reference_constructor.xml:1487 +#: reference_constructor.xml:1480 #, no-c-format msgid "&sqlmm_compliant;SQL-MM 3: 9.4.4" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1495 +#: reference_constructor.xml:1488 #, no-c-format msgid "SELECT ST_MLineFromText('MULTILINESTRING((1 2, 3 4), (4 5, 6 7))');" msgstr "" #. Tag: refname -#: reference_constructor.xml:1508 +#: reference_constructor.xml:1501 #, no-c-format msgid "ST_MPointFromText" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1510 reference_constructor.xml:1880 +#: reference_constructor.xml:1503 reference_constructor.xml:1873 #, no-c-format msgid "Makes a Geometry from WKT with the given SRID. If SRID is not give, it defaults to 0." msgstr "" #. Tag: funcsynopsis -#: reference_constructor.xml:1515 +#: reference_constructor.xml:1508 #, no-c-format msgid " geometry ST_MPointFromText text WKT integer srid geometry ST_MPointFromText text WKT " msgstr "" #. Tag: para -#: reference_constructor.xml:1533 +#: reference_constructor.xml:1526 #, no-c-format msgid "Makes a Geometry from WKT with the given SRID. If SRID is not give, it defaults to 0." msgstr "" #. Tag: para -#: reference_constructor.xml:1539 +#: reference_constructor.xml:1532 #, no-c-format msgid "Returns null if the WKT is not a MULTIPOINT" msgstr "" #. Tag: para -#: reference_constructor.xml:1547 +#: reference_constructor.xml:1540 #, no-c-format msgid "&sfs_compliant; 3.2.6.2" msgstr "" #. Tag: para -#: reference_constructor.xml:1548 +#: reference_constructor.xml:1541 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 9.2.4" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1556 +#: reference_constructor.xml:1549 #, no-c-format msgid "" "SELECT ST_MPointFromText('MULTIPOINT(1 2, 3 4)');\n" @@ -2188,49 +2168,49 @@ msgid "" msgstr "" #. Tag: refname -#: reference_constructor.xml:1569 +#: reference_constructor.xml:1562 #, no-c-format msgid "ST_MPolyFromText" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1571 +#: reference_constructor.xml:1564 #, no-c-format msgid "Makes a MultiPolygon Geometry from WKT with the given SRID. If SRID is not give, it defaults to 0." msgstr "" #. Tag: funcsynopsis -#: reference_constructor.xml:1576 +#: reference_constructor.xml:1569 #, no-c-format msgid " geometry ST_MPolyFromText text WKT integer srid geometry ST_MPolyFromText text WKT " msgstr "" #. Tag: para -#: reference_constructor.xml:1594 +#: reference_constructor.xml:1587 #, no-c-format msgid "Makes a MultiPolygon from WKT with the given SRID. If SRID is not give, it defaults to 0." msgstr "" #. Tag: para -#: reference_constructor.xml:1600 +#: reference_constructor.xml:1593 #, no-c-format msgid "Throws an error if the WKT is not a MULTIPOLYGON" msgstr "" #. Tag: para -#: reference_constructor.xml:1603 +#: reference_constructor.xml:1596 #, no-c-format msgid "If you are absolutely sure all your WKT geometries are multipolygons, don't use this function. It is slower than ST_GeomFromText since it adds an additional validation step." msgstr "" #. Tag: para -#: reference_constructor.xml:1609 +#: reference_constructor.xml:1602 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 9.6.4" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1617 +#: reference_constructor.xml:1610 #, 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" @@ -2239,61 +2219,61 @@ msgid "" msgstr "" #. Tag: refname -#: reference_constructor.xml:1630 +#: reference_constructor.xml:1623 #, no-c-format msgid "ST_Point" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1632 +#: reference_constructor.xml:1625 #, no-c-format msgid "Returns an ST_Point with the given coordinate values. OGC alias for ST_MakePoint." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:1637 +#: reference_constructor.xml:1630 #, no-c-format msgid "geometry ST_Point float x_lon float y_lat" msgstr "" #. Tag: para -#: reference_constructor.xml:1648 +#: reference_constructor.xml:1641 #, 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:1651 +#: reference_constructor.xml:1644 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 6.1.2" msgstr "" #. Tag: title -#: reference_constructor.xml:1657 +#: reference_constructor.xml:1650 #, no-c-format msgid "Examples: Geometry" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1659 +#: reference_constructor.xml:1652 #, no-c-format msgid "SELECT ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326)" msgstr "" #. Tag: title -#: reference_constructor.xml:1663 +#: reference_constructor.xml:1656 #, no-c-format msgid "Examples: Geography" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1665 +#: reference_constructor.xml:1658 #, no-c-format msgid "SELECT CAST(ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326) As geography);" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1666 +#: reference_constructor.xml:1659 #, no-c-format msgid "" "-- the :: is PostgreSQL short-hand for casting.\n" @@ -2301,7 +2281,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1668 +#: reference_constructor.xml:1661 #, 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" @@ -2310,49 +2290,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:1675 +#: reference_constructor.xml:1668 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_constructor.xml:1681 +#: reference_constructor.xml:1674 #, no-c-format msgid "ST_PointFromGeoHash" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1683 +#: reference_constructor.xml:1676 #, no-c-format msgid "Return a point from a GeoHash string." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:1688 +#: reference_constructor.xml:1681 #, no-c-format msgid "point ST_PointFromGeoHash text geohash integer precision=full_precision_of_geohash" msgstr "" #. Tag: para -#: reference_constructor.xml:1699 +#: reference_constructor.xml:1692 #, no-c-format msgid "Return a point from a GeoHash string. The point represents the center point of the GeoHash." msgstr "" #. Tag: para -#: reference_constructor.xml:1701 +#: reference_constructor.xml:1694 #, no-c-format msgid "If no precision is specficified ST_PointFromGeoHash returns a point based on full precision of the input GeoHash string." msgstr "" #. Tag: para -#: reference_constructor.xml:1703 +#: reference_constructor.xml:1696 #, 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_constructor.xml:1710 +#: reference_constructor.xml:1703 #, no-c-format msgid "" ", " msgstr "" #. Tag: refname -#: reference_constructor.xml:1721 +#: reference_constructor.xml:1714 #, no-c-format msgid "ST_PointFromText" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1722 +#: reference_constructor.xml:1715 #, no-c-format msgid "Makes a point Geometry from WKT with the given SRID. If SRID is not given, it defaults to unknown." msgstr "" #. Tag: funcsynopsis -#: reference_constructor.xml:1726 +#: reference_constructor.xml:1719 #, no-c-format msgid " geometry ST_PointFromText text WKT geometry ST_PointFromText text WKT integer srid " msgstr "" #. Tag: para -#: reference_constructor.xml:1742 +#: reference_constructor.xml:1735 #, no-c-format msgid "Constructs a PostGIS ST_Geometry point object from the OGC Well-Known text representation. If SRID is not give, it defaults to unknown (currently 0). If geometry is not a WKT point representation, returns null. If completely invalid WKT, then throws an error." msgstr "" #. Tag: para -#: reference_constructor.xml:1748 +#: reference_constructor.xml:1741 #, no-c-format msgid "There are 2 variants of ST_PointFromText function, the first takes no SRID and returns a geometry with no defined spatial reference system. The second takes a spatial reference id as the second argument and returns an ST_Geometry that includes this srid as part of its meta-data. The srid must be defined in the spatial_ref_sys table." msgstr "" #. Tag: para -#: reference_constructor.xml:1755 +#: reference_constructor.xml:1748 #, 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_constructor.xml:1760 +#: reference_constructor.xml:1753 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 6.1.8" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1765 +#: reference_constructor.xml:1758 #, no-c-format msgid "" "SELECT ST_PointFromText('POINT(-71.064544 42.28787)');\n" @@ -2429,49 +2409,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:1769 +#: reference_constructor.xml:1762 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_constructor.xml:1775 +#: reference_constructor.xml:1768 #, no-c-format msgid "ST_PointFromWKB" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1777 +#: reference_constructor.xml:1770 #, no-c-format msgid "Makes a geometry from WKB with the given SRID" msgstr "" #. Tag: para -#: reference_constructor.xml:1798 +#: reference_constructor.xml:1791 #, 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_constructor.xml:1804 +#: reference_constructor.xml:1797 #, 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:1807 +#: reference_constructor.xml:1800 #, no-c-format msgid "&sfs_compliant; s3.2.7.2" msgstr "" #. Tag: para -#: reference_constructor.xml:1808 +#: reference_constructor.xml:1801 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 6.1.9" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1816 +#: reference_constructor.xml:1809 #, no-c-format msgid "" "SELECT\n" @@ -2498,43 +2478,43 @@ msgid "" msgstr "" #. Tag: refname -#: reference_constructor.xml:1829 +#: reference_constructor.xml:1822 #, no-c-format msgid "ST_Polygon" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1831 +#: reference_constructor.xml:1824 #, no-c-format msgid "Returns a polygon built from the specified linestring and SRID." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:1836 +#: reference_constructor.xml:1829 #, no-c-format msgid "geometry ST_Polygon geometry aLineString integer srid" msgstr "" #. Tag: para -#: reference_constructor.xml:1847 +#: reference_constructor.xml:1840 #, no-c-format msgid "Returns a polygon built from the specified linestring and SRID." msgstr "" #. Tag: para -#: reference_constructor.xml:1851 +#: reference_constructor.xml:1844 #, no-c-format msgid "ST_Polygon is similar to first version oST_MakePolygon except it also sets the spatial ref sys (SRID) of the polygon. Will not work with MULTILINESTRINGS so use LineMerge to merge multilines. Also does not create polygons with holes. Use ST_MakePolygon for that." msgstr "" #. Tag: para -#: reference_constructor.xml:1856 +#: reference_constructor.xml:1849 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 8.3.2" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1865 +#: reference_constructor.xml:1858 #, no-c-format msgid "" "--a 2d polygon\n" @@ -2551,43 +2531,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_constructor.xml:1872 +#: reference_constructor.xml:1865 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_constructor.xml:1878 +#: reference_constructor.xml:1871 #, no-c-format msgid "ST_PolygonFromText" msgstr "" #. Tag: funcsynopsis -#: reference_constructor.xml:1885 +#: reference_constructor.xml:1878 #, no-c-format msgid " geometry ST_PolygonFromText text WKT geometry ST_PolygonFromText text WKT integer srid " msgstr "" #. Tag: para -#: reference_constructor.xml:1901 +#: reference_constructor.xml:1894 #, no-c-format msgid "Makes a Geometry from WKT with the given SRID. If SRID is not give, it defaults to 0. Returns null if WKT is not a polygon." msgstr "" #. Tag: para -#: reference_constructor.xml:1908 +#: reference_constructor.xml:1901 #, no-c-format msgid "If you are absolutely sure all your WKT geometries are polygons, don't use this function. It is slower than ST_GeomFromText since it adds an additional validation step." msgstr "" #. Tag: para -#: reference_constructor.xml:1911 +#: reference_constructor.xml:1904 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 8.3.6" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1917 +#: reference_constructor.xml:1910 #, no-c-format msgid "" "SELECT ST_PolygonFromText('POLYGON((-71.1776585052917 42.3902909739571,-71.1776820268866 42.3903701743239,\n" @@ -2605,43 +2585,43 @@ msgid "" msgstr "" #. Tag: refname -#: reference_constructor.xml:1930 +#: reference_constructor.xml:1923 #, no-c-format msgid "ST_WKBToSQL" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1931 +#: reference_constructor.xml:1924 #, no-c-format msgid "Return a specified ST_Geometry value from Well-Known Binary representation (WKB). This is an alias name for ST_GeomFromWKB that takes no srid" msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:1935 +#: reference_constructor.xml:1928 #, no-c-format msgid "geometry ST_WKBToSQL bytea WKB" msgstr "" #. Tag: para -#: reference_constructor.xml:1943 +#: reference_constructor.xml:1936 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.36" msgstr "" #. Tag: refname -#: reference_constructor.xml:1953 +#: reference_constructor.xml:1946 #, no-c-format msgid "ST_WKTToSQL" msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:1958 +#: reference_constructor.xml:1951 #, no-c-format msgid "geometry ST_WKTToSQL text WKT" msgstr "" #. Tag: para -#: reference_constructor.xml:1966 +#: reference_constructor.xml:1959 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.34" msgstr "" diff --git a/doc/po/templates/reference_editor.xml.pot b/doc/po/templates/reference_editor.xml.pot index fde7aed4c..f07be21e5 100644 --- a/doc/po/templates/reference_editor.xml.pot +++ b/doc/po/templates/reference_editor.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -45,7 +45,7 @@ msgid "geometry ST_AddPoint Scales the geometry to a new size by multiplying the ordinates with the parameters. Ie: ST_Scale(geom, Xfactor, Yfactor, Zfactor)." +msgid "Scales the geometry to a new size by multiplying the ordinates with the parameters. Ie: ST_Scale(geom, Xfactor, Yfactor, Zfactor)." msgstr "" #. Tag: funcsynopsis #: reference_editor.xml:973 #, no-c-format -msgid " geometry ST_Scale geometry geomA float XFactor float YFactor float ZFactor geometry ST_Scale geometry geomA float XFactor float YFactor " +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 " msgstr "" #. Tag: para -#: reference_editor.xml:994 +#: reference_editor.xml:1000 #, no-c-format -msgid "Scales the geometry to a new size by multiplying the ordinates with the parameters. Ie: ST_Scale(geom, Xfactor, Yfactor, Zfactor)." +msgid "Scales the geometry to a new size by multiplying the ordinates with the corresponding factor parameters." msgstr "" #. Tag: para -#: reference_editor.xml:998 +#: reference_editor.xml:1004 #, no-c-format -msgid "ST_Scale(geomA, XFactor, YFactor, ZFactor) is short-hand for ST_Affine(geomA, XFactor, 0, 0, 0, YFactor, 0, 0, 0, ZFactor, 0, 0, 0)." +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 equivalant to no scaling the corresponding dimension." msgstr "" #. Tag: para -#: reference_editor.xml:1004 reference_editor.xml:1577 +#: reference_editor.xml:1014 reference_editor.xml:1589 #, no-c-format msgid "Availability: 1.1.0." msgstr "" -#. Tag: programlisting +#. Tag: para #: reference_editor.xml:1016 #, no-c-format +msgid "Enhanced: 2.2.0 support for scaling all dimension (geometry parameter) was introduced." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1021 +#, no-c-format +msgid "&M_support;" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1028 +#, 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" @@ -1263,65 +1275,72 @@ msgid "" " 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)" + " 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)" msgstr "" #. Tag: para -#: reference_editor.xml:1023 +#: reference_editor.xml:1035 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_editor.xml:1029 +#: reference_editor.xml:1041 #, no-c-format msgid "ST_Segmentize" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:1031 +#: reference_editor.xml:1043 #, no-c-format msgid "Return a modified geometry/geography having no segment longer than the given distance. Distance computation is performed in 2d only. For geometry, length units are in units of spatial reference. For geography, units are in meters." msgstr "" #. Tag: funcsynopsis -#: reference_editor.xml:1037 +#: reference_editor.xml:1049 #, no-c-format msgid " geometry ST_Segmentize geometry geom float max_segment_length geography ST_Segmentize geography geog float max_segment_length " msgstr "" #. Tag: para -#: reference_editor.xml:1054 +#: reference_editor.xml:1066 #, no-c-format msgid "Returns a modified geometry having no segment longer than the given max_segment_length. Distance computation is performed in 2d only. For geometry, length units are in units of spatial reference. For geography, units are in meters." msgstr "" #. Tag: para -#: reference_editor.xml:1057 reference_editor.xml:1518 +#: reference_editor.xml:1069 reference_editor.xml:1530 #, no-c-format msgid "Availability: 1.2.2" msgstr "" #. Tag: para -#: reference_editor.xml:1058 +#: reference_editor.xml:1070 #, no-c-format msgid "Enhanced: 2.1.0 support for geography was introduced." msgstr "" #. Tag: para -#: reference_editor.xml:1059 +#: reference_editor.xml:1071 #, no-c-format msgid "Changed: 2.1.0 As a result of the introduction of geography support: The construct SELECT ST_Segmentize('LINESTRING(1 2, 3 4)',0.5); will result in ambiguous function error. You need to have properly typed object e.g. a geometry/geography column, use ST_GeomFromText, ST_GeogFromText or SELECT ST_Segmentize('LINESTRING(1 2, 3 4)'::geometry,0.5);" msgstr "" #. Tag: para -#: reference_editor.xml:1061 +#: reference_editor.xml:1073 #, no-c-format msgid "This will only increase segments. It will not lengthen segments shorter than max length" msgstr "" #. Tag: programlisting -#: reference_editor.xml:1068 +#: reference_editor.xml:1080 #, no-c-format msgid "" "SELECT ST_AsText(ST_Segmentize(\n" @@ -1343,31 +1362,31 @@ msgid "" msgstr "" #. Tag: refname -#: reference_editor.xml:1078 +#: reference_editor.xml:1090 #, no-c-format msgid "ST_SetPoint" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:1079 +#: reference_editor.xml:1091 #, no-c-format msgid "Replace point N of linestring with given point. Index is 0-based." msgstr "" #. Tag: funcprototype -#: reference_editor.xml:1084 +#: reference_editor.xml:1096 #, no-c-format msgid "geometry ST_SetPoint geometry linestring integer zerobasedposition geometry point" msgstr "" #. Tag: para -#: reference_editor.xml:1096 +#: reference_editor.xml:1108 #, no-c-format msgid "Replace point N of linestring with given point. Index is 0-based. This is especially useful in triggers when trying to maintain relationship of joints when one vertex moves." msgstr "" #. Tag: programlisting -#: reference_editor.xml:1106 +#: reference_editor.xml:1118 #, no-c-format msgid "" "--Change first point in line string from -1 3 to -1 1\n" @@ -1385,55 +1404,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1110 +#: reference_editor.xml:1122 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_editor.xml:1116 +#: reference_editor.xml:1128 #, no-c-format msgid "ST_SetSRID" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:1118 +#: reference_editor.xml:1130 #, no-c-format msgid "Sets the SRID on a geometry to a particular integer value." msgstr "" #. Tag: funcprototype -#: reference_editor.xml:1124 +#: reference_editor.xml:1136 #, no-c-format msgid "geometry ST_SetSRID geometry geom integer srid" msgstr "" #. Tag: para -#: reference_editor.xml:1139 +#: reference_editor.xml:1151 #, 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:1143 +#: reference_editor.xml:1155 #, 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:1148 +#: reference_editor.xml:1160 #, no-c-format msgid "&sfs_compliant;" msgstr "" #. Tag: para -#: reference_editor.xml:1154 +#: reference_editor.xml:1166 #, no-c-format msgid "-- Mark a point as WGS 84 long lat --" msgstr "" #. Tag: programlisting -#: reference_editor.xml:1155 +#: reference_editor.xml:1167 #, no-c-format msgid "" "SELECT ST_SetSRID(ST_Point(-123.365556, 48.428611),4326) As wgs84long_lat;\n" @@ -1442,13 +1461,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1156 +#: reference_editor.xml:1168 #, 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:1157 +#: reference_editor.xml:1169 #, no-c-format msgid "" "SELECT ST_Transform(ST_SetSRID(ST_Point(-123.365556, 48.428611),4326),3785) As spere_merc;\n" @@ -1457,67 +1476,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1163 +#: reference_editor.xml:1175 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_editor.xml:1170 +#: reference_editor.xml:1182 #, no-c-format msgid "ST_SnapToGrid" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:1172 +#: reference_editor.xml:1184 #, no-c-format msgid "Snap all points of the input geometry to a regular grid." msgstr "" #. Tag: funcsynopsis -#: reference_editor.xml:1178 +#: reference_editor.xml:1190 #, no-c-format msgid " geometry ST_SnapToGrid geometry geomA float originX float originY float sizeX float sizeY geometry ST_SnapToGrid geometry geomA float sizeX float sizeY geometry ST_SnapToGrid geometry geomA float size geometry ST_SnapToGrid geometry geomA geometry pointOrigin float sizeX float sizeY float sizeZ float sizeM " msgstr "" #. Tag: para -#: reference_editor.xml:1216 +#: reference_editor.xml:1228 #, no-c-format msgid "Variant 1,2,3: Snap all points of the input geometry to the grid defined by its origin and cell size. Remove consecutive points falling on the same cell, eventually returning NULL if output points are not enough to define a geometry of the given type. Collapsed geometries in a collection are stripped from it. Useful for reducing precision." msgstr "" #. Tag: para -#: reference_editor.xml:1224 +#: reference_editor.xml:1236 #, no-c-format msgid "Variant 4: Introduced 1.1.0 - Snap all points of the input geometry to the grid defined by its origin (the second argument, must be a point) and cell sizes. Specify 0 as size for any dimension you don't want to snap to a grid." msgstr "" #. Tag: para -#: reference_editor.xml:1230 +#: reference_editor.xml:1242 #, no-c-format msgid "The returned geometry might loose its simplicity (see )." msgstr "" #. Tag: para -#: reference_editor.xml:1235 +#: reference_editor.xml:1247 #, no-c-format msgid "Before release 1.1.0 this function always returned a 2d geometry. Starting at 1.1.0 the returned geometry will have same dimensionality as the input one with higher dimension values untouched. Use the version taking a second geometry argument to define all grid dimensions." msgstr "" #. Tag: para -#: reference_editor.xml:1242 +#: reference_editor.xml:1254 #, no-c-format msgid "Availability: 1.0.0RC1" msgstr "" #. Tag: para -#: reference_editor.xml:1243 +#: reference_editor.xml:1255 #, no-c-format msgid "Availability: 1.1.0 - Z and M support" msgstr "" #. Tag: programlisting -#: reference_editor.xml:1252 +#: reference_editor.xml:1264 #, no-c-format msgid "" "--Snap your geometries to a precision grid of 10^-3\n" @@ -1552,73 +1571,73 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1259 +#: reference_editor.xml:1271 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_editor.xml:1272 +#: reference_editor.xml:1284 #, no-c-format msgid "ST_Snap" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:1274 +#: reference_editor.xml:1286 #, no-c-format msgid "Snap segments and vertices of input geometry to vertices of a reference geometry." msgstr "" #. Tag: funcprototype -#: reference_editor.xml:1282 +#: reference_editor.xml:1294 #, no-c-format msgid "geometry ST_Snap geometry input geometry reference float tolerance" msgstr "" #. Tag: para -#: reference_editor.xml:1294 +#: reference_editor.xml:1306 #, no-c-format msgid "Snaps the vertices and segments of a geometry another Geometry's vertices. A snap distance tolerance is used to control where snapping is performed." msgstr "" #. Tag: para -#: reference_editor.xml:1299 +#: reference_editor.xml:1311 #, no-c-format msgid "Snapping one geometry to another can improve robustness for overlay operations by eliminating nearly-coincident edges (which cause problems during noding and intersection calculation)." msgstr "" #. Tag: para -#: reference_editor.xml:1306 +#: reference_editor.xml:1318 #, no-c-format msgid "Too much snapping can result in invalid topology being created, so the number and location of snapped vertices is decided using heuristics to determine when it is safe to snap. This can result in some potential snaps being omitted, however." msgstr "" #. Tag: para -#: reference_editor.xml:1315 +#: reference_editor.xml:1327 #, no-c-format msgid "The returned geometry might loose its simplicity (see ) and validity (see )." msgstr "" #. Tag: para -#: reference_editor.xml:1322 +#: reference_editor.xml:1334 #, no-c-format msgid "Availability: 2.0.0 requires GEOS >= 3.3.0." msgstr "" #. Tag: para -#: reference_editor.xml:1339 +#: reference_editor.xml:1351 #, no-c-format msgid "A multipolygon shown with a linestring (before any snapping)" msgstr "" #. Tag: para -#: reference_editor.xml:1350 +#: reference_editor.xml:1362 #, no-c-format msgid "A multipolygon snapped to linestring to tolerance: 1.01 of distance. The new multipolygon is shown with reference linestring" msgstr "" #. Tag: programlisting -#: reference_editor.xml:1354 +#: reference_editor.xml:1366 #, no-c-format msgid "" "SELECT ST_AsText(ST_Snap(poly,line, ST_Distance(poly,line)*1.01)) AS polysnapped\n" @@ -1638,13 +1657,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1361 +#: reference_editor.xml:1373 #, no-c-format msgid "A multipolygon snapped to linestring to tolerance: 1.25 of distance. The new multipolygon is shown with reference linestring" msgstr "" #. Tag: programlisting -#: reference_editor.xml:1365 +#: reference_editor.xml:1377 #, no-c-format msgid "" "SELECT ST_AsText(\n" @@ -1666,13 +1685,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1374 +#: reference_editor.xml:1386 #, no-c-format msgid "The linestring snapped to the original multipolygon at tolerance 1.01 of distance. The new linestring is shown with reference multipolygon" msgstr "" #. Tag: programlisting -#: reference_editor.xml:1378 +#: reference_editor.xml:1390 #, no-c-format msgid "" "SELECT ST_AsText(\n" @@ -1692,13 +1711,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1386 +#: reference_editor.xml:1398 #, no-c-format msgid "The linestring snapped to the original multipolygon at tolerance 1.25 of distance. The new linestring is shown with reference multipolygon" msgstr "" #. Tag: programlisting -#: reference_editor.xml:1390 +#: reference_editor.xml:1402 #, no-c-format msgid "" "SELECT ST_AsText(\n" @@ -1717,61 +1736,61 @@ msgid "" msgstr "" #. Tag: refname -#: reference_editor.xml:1411 +#: reference_editor.xml:1423 #, no-c-format msgid "ST_Transform" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:1413 +#: reference_editor.xml:1425 #, no-c-format msgid "Returns a new geometry with its coordinates transformed to the SRID referenced by the integer parameter." msgstr "" #. Tag: funcprototype -#: reference_editor.xml:1419 +#: reference_editor.xml:1431 #, no-c-format msgid "geometry ST_Transform geometry g1 integer srid" msgstr "" #. Tag: para -#: reference_editor.xml:1430 +#: reference_editor.xml:1442 #, no-c-format msgid "Returns a new geometry with its coordinates transformed to spatial reference system referenced by the SRID integer parameter. The destination SRID must exist in the SPATIAL_REF_SYS table." msgstr "" #. Tag: para -#: reference_editor.xml:1433 +#: reference_editor.xml:1445 #, 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:1438 +#: reference_editor.xml:1450 #, 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:1442 +#: reference_editor.xml:1454 #, 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:1449 +#: reference_editor.xml:1461 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.6" msgstr "" #. Tag: para -#: reference_editor.xml:1457 +#: reference_editor.xml:1469 #, no-c-format msgid "Change Mass state plane US feet geometry to WGS 84 long lat" msgstr "" #. Tag: programlisting -#: reference_editor.xml:1458 +#: reference_editor.xml:1470 #, no-c-format msgid "" "SELECT ST_AsText(ST_Transform(ST_GeomFromText('POLYGON((743238 2967416,743238 2967450,\n" @@ -1795,13 +1814,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1459 +#: reference_editor.xml:1471 #, 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:1461 +#: reference_editor.xml:1473 #, no-c-format msgid "" "CREATE INDEX idx_the_geom_26986_parcels\n" @@ -1812,97 +1831,97 @@ msgid "" msgstr "" #. Tag: title -#: reference_editor.xml:1465 +#: reference_editor.xml:1477 #, no-c-format msgid "Configuring transformation behaviour" msgstr "" #. Tag: para -#: reference_editor.xml:1466 +#: reference_editor.xml:1478 #, no-c-format msgid "Sometimes coordinate transformation involving a grid-shift can fail, for example if PROJ.4 has not been built with grid-shift files or the coordinate does not lie within the range for which the grid shift is defined. By default, PostGIS will throw an error if a grid shift file is not present, but this behaviour can be configured on a per-SRID basis by altering the proj4text value within the spatial_ref_sys table." msgstr "" #. Tag: para -#: reference_editor.xml:1467 +#: reference_editor.xml:1479 #, 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:1468 +#: reference_editor.xml:1480 #, no-c-format msgid "+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat" msgstr "" #. Tag: para -#: reference_editor.xml:1469 +#: reference_editor.xml:1481 #, 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:1470 +#: reference_editor.xml:1482 #, 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:1471 +#: reference_editor.xml:1483 #, no-c-format msgid "+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat,null" msgstr "" #. Tag: para -#: reference_editor.xml:1472 +#: reference_editor.xml:1484 #, 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:1473 +#: reference_editor.xml:1485 #, 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:1480 +#: reference_editor.xml:1492 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_editor.xml:1486 +#: reference_editor.xml:1498 #, no-c-format msgid "ST_Translate" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:1488 +#: reference_editor.xml:1500 #, no-c-format msgid "Translates the geometry to a new location using the numeric parameters as offsets. Ie: ST_Translate(geom, X, Y) or ST_Translate(geom, X, Y,Z)." msgstr "" #. Tag: funcsynopsis -#: reference_editor.xml:1493 +#: reference_editor.xml:1505 #, 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:1513 +#: reference_editor.xml:1525 #, 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:1525 +#: reference_editor.xml:1537 #, no-c-format msgid "Move a point 1 degree longitude" msgstr "" #. Tag: programlisting -#: reference_editor.xml:1526 +#: reference_editor.xml:1538 #, no-c-format msgid "" "SELECT ST_AsText(ST_Translate(ST_GeomFromText('POINT(-71.01 42.37)',4326),1,0)) As wgs_transgeomtxt;\n" @@ -1913,13 +1932,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1527 +#: reference_editor.xml:1539 #, no-c-format msgid "Move a linestring 1 degree longitude and 1/2 degree latitude" msgstr "" #. Tag: programlisting -#: reference_editor.xml:1528 +#: reference_editor.xml:1540 #, 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" @@ -1929,13 +1948,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1529 +#: reference_editor.xml:1541 #, no-c-format msgid "Move a 3d point" msgstr "" #. Tag: programlisting -#: reference_editor.xml:1530 +#: reference_editor.xml:1542 #, no-c-format msgid "" "SELECT ST_AsEWKT(ST_Translate(CAST('POINT(0 0 0)' As geometry), 5, 12,3));\n" @@ -1945,13 +1964,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1531 +#: reference_editor.xml:1543 #, no-c-format msgid "Move a curve and a point" msgstr "" #. Tag: programlisting -#: reference_editor.xml:1532 +#: reference_editor.xml:1544 #, 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" @@ -1961,43 +1980,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1538 +#: reference_editor.xml:1550 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_editor.xml:1544 +#: reference_editor.xml:1556 #, no-c-format msgid "ST_TransScale" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:1546 +#: reference_editor.xml:1558 #, 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: funcprototype -#: reference_editor.xml:1553 +#: reference_editor.xml:1565 #, no-c-format msgid "geometry ST_TransScale geometry geomA float deltaX float deltaY float XFactor float YFactor" msgstr "" #. Tag: para -#: reference_editor.xml:1567 +#: reference_editor.xml:1579 #, 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:1570 +#: reference_editor.xml:1582 #, 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_editor.xml:1586 +#: reference_editor.xml:1598 #, no-c-format msgid "" "SELECT ST_AsEWKT(ST_TransScale(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), 0.5, 1, 1, 2));\n" @@ -2014,7 +2033,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1593 +#: reference_editor.xml:1605 #, no-c-format msgid ", " msgstr "" diff --git a/doc/po/templates/reference_guc.xml.pot b/doc/po/templates/reference_guc.xml.pot index eba38dbac..b559c4112 100644 --- a/doc/po/templates/reference_guc.xml.pot +++ b/doc/po/templates/reference_guc.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -39,7 +39,7 @@ msgid "The backend to service a function where GEOS and SFCGAL overlap. Options: msgstr "" #. Tag: title -#: reference_guc.xml:17 reference_guc.xml:45 reference_guc.xml:95 reference_guc.xml:180 +#: reference_guc.xml:17 reference_guc.xml:45 reference_guc.xml:95 reference_guc.xml:187 #, no-c-format msgid "Description" msgstr "" @@ -57,7 +57,7 @@ msgid "Availability: 2.1.0" msgstr "" #. Tag: title -#: reference_guc.xml:23 reference_guc.xml:69 reference_guc.xml:146 reference_guc.xml:206 +#: reference_guc.xml:23 reference_guc.xml:69 reference_guc.xml:146 reference_guc.xml:213 #, no-c-format msgid "Examples" msgstr "" @@ -87,7 +87,7 @@ msgid "ALTER DATABASE mygisdb SET postgis.backend = sfcgal;" msgstr "" #. Tag: title -#: reference_guc.xml:31 reference_guc.xml:79 reference_guc.xml:159 reference_guc.xml:213 +#: reference_guc.xml:31 reference_guc.xml:79 reference_guc.xml:166 reference_guc.xml:220 #, no-c-format msgid "See Also" msgstr "" @@ -123,7 +123,7 @@ msgid "This option can be set in PostgreSQL's configuration file postgresql.conf msgstr "" #. Tag: para -#: reference_guc.xml:58 reference_guc.xml:141 reference_guc.xml:201 +#: reference_guc.xml:58 reference_guc.xml:141 reference_guc.xml:208 #, no-c-format msgid "Availability: 2.2.0" msgstr "" @@ -246,88 +246,114 @@ msgstr "" msgid "Set and reset postgis.gdal_enabled_drivers" msgstr "" -#. Tag: programlisting +#. Tag: para #: reference_guc.xml:149 #, no-c-format +msgid "Sets backend for all new connections to database" +msgstr "" + +#. Tag: programlisting +#: reference_guc.xml:150 +#, no-c-format +msgid "ALTER DATABASE mygisdb SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';" +msgstr "" + +#. Tag: para +#: reference_guc.xml:152 +#, no-c-format +msgid "Sets default enabled drivers for all new connections to server. Requires super user access and PostgreSQL 9.4+. Also not that database, session, and user settings override this." +msgstr "" + +#. Tag: programlisting +#: reference_guc.xml:154 +#, no-c-format +msgid "" + "ALTER SYSTEM SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';\n" + "SELECT pg_reload_conf();" +msgstr "" + +#. Tag: programlisting +#: reference_guc.xml:156 +#, no-c-format msgid "" "SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';\n" "SET postgis.gdal_enabled_drivers = default;" msgstr "" #. Tag: para -#: reference_guc.xml:151 +#: reference_guc.xml:158 #, no-c-format msgid "Enable all GDAL Drivers" msgstr "" #. Tag: programlisting -#: reference_guc.xml:152 +#: reference_guc.xml:159 #, no-c-format msgid "SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';" msgstr "" #. Tag: para -#: reference_guc.xml:154 +#: reference_guc.xml:161 #, no-c-format msgid "Disable all GDAL Drivers" msgstr "" #. Tag: programlisting -#: reference_guc.xml:155 +#: reference_guc.xml:162 #, no-c-format msgid "SET postgis.gdal_enabled_drivers = 'DISABLE_ALL';" msgstr "" #. Tag: para -#: reference_guc.xml:160 +#: reference_guc.xml:167 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_guc.xml:173 +#: reference_guc.xml:180 #, no-c-format msgid "postgis.enable_outdb_rasters" msgstr "" #. Tag: refpurpose -#: reference_guc.xml:174 +#: reference_guc.xml:181 #, no-c-format msgid "A boolean configuration option to enable access to out-db raster bands." msgstr "" #. Tag: para -#: reference_guc.xml:181 +#: reference_guc.xml:188 #, no-c-format msgid "A boolean configuration option to enable access to out-db raster bands. This option can be set in PostgreSQL's configuration file: postgresql.conf. It can also be set by connection or transaction." msgstr "" #. Tag: para -#: reference_guc.xml:185 +#: reference_guc.xml:192 #, no-c-format msgid "The initial value of postgis.enable_outdb_rasters may also be set by passing the environment variable POSTGIS_ENABLE_OUTDB_RASTERS with a non-zero value to the process starting PostgreSQL." msgstr "" #. Tag: para -#: reference_guc.xml:190 +#: reference_guc.xml:197 #, no-c-format msgid "Even if postgis.enable_outdb_rasters is True, the GUC postgis.enable_outdb_rasters determines the accessible raster formats." msgstr "" #. Tag: para -#: reference_guc.xml:196 +#: reference_guc.xml:203 #, no-c-format msgid "In the standard PostGIS installation, postgis.enable_outdb_rasters is set to False." msgstr "" #. Tag: para -#: reference_guc.xml:207 +#: reference_guc.xml:214 #, no-c-format msgid "Set and reset postgis.enable_outdb_rasters" msgstr "" #. Tag: programlisting -#: reference_guc.xml:209 +#: reference_guc.xml:216 #, no-c-format msgid "" "SET postgis.enable_outdb_rasters TO True;\n" diff --git a/doc/po/templates/reference_lrs.xml.pot b/doc/po/templates/reference_lrs.xml.pot index 0b8f5a5e9..3c15e220f 100644 --- a/doc/po/templates/reference_lrs.xml.pot +++ b/doc/po/templates/reference_lrs.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -35,7 +35,7 @@ msgstr "" #. Tag: funcprototype #: reference_lrs.xml:15 #, no-c-format -msgid "geometry ST_LineInterpolatePoint geometry a_linestring float a_fraction" +msgid "geometry ST_LineInterpolatePoint geometry a_linestring float8 a_fraction" msgstr "" #. Tag: title @@ -152,7 +152,7 @@ msgstr "" #. Tag: funcprototype #: reference_lrs.xml:77 #, no-c-format -msgid "float ST_LineLocatePoint geometry a_linestring geometry a_point" +msgid "float8 ST_LineLocatePoint geometry a_linestring geometry a_point" msgstr "" #. Tag: para @@ -241,7 +241,7 @@ msgstr "" #. Tag: funcprototype #: reference_lrs.xml:128 #, no-c-format -msgid "geometry ST_LineSubstring geometry a_linestring float startfraction float endfraction" +msgid "geometry ST_LineSubstring geometry a_linestring float8 startfraction float8 endfraction" msgstr "" #. Tag: para @@ -337,7 +337,7 @@ msgstr "" #. Tag: funcprototype #: reference_lrs.xml:195 #, no-c-format -msgid "geometry ST_LocateAlong geometry ageom_with_measure float a_measure float offset" +msgid "geometry ST_LocateAlong geometry ageom_with_measure float8 a_measure float8 offset" msgstr "" #. Tag: para @@ -432,7 +432,7 @@ msgstr "" #. Tag: funcprototype #: reference_lrs.xml:251 #, no-c-format -msgid "geometry ST_LocateBetween geometry geomA float measure_start float measure_end float offset" +msgid "geometry ST_LocateBetween geometry geomA float8 measure_start float8 measure_end float8 offset" msgstr "" #. Tag: para @@ -502,7 +502,7 @@ msgstr "" #. Tag: funcprototype #: reference_lrs.xml:303 #, no-c-format -msgid "geometry ST_LocateBetweenElevations geometry geom_mline float elevation_start float elevation_end" +msgid "geometry ST_LocateBetweenElevations geometry geom_mline float8 elevation_start float8 elevation_end" msgstr "" #. Tag: para @@ -562,7 +562,7 @@ msgstr "" #. Tag: funcprototype #: reference_lrs.xml:349 #, no-c-format -msgid "float ST_InterpolatePoint geometry line geometry point" +msgid "float8 ST_InterpolatePoint geometry line geometry point" msgstr "" #. Tag: para @@ -602,19 +602,19 @@ msgstr "" #. Tag: refpurpose #: reference_lrs.xml:387 #, no-c-format -msgid "Return a derived geometry with measure elements linearly interpolated between the start and end points. If the geometry has no measure dimension, one is added. If the geometry has a measure dimension, it is over-written with new values. Only LINESTRINGS and MULTILINESTRINGS are supported." +msgid "Return a derived geometry with measure elements linearly interpolated between the start and end points." msgstr "" #. Tag: funcprototype #: reference_lrs.xml:392 #, no-c-format -msgid "geometry ST_AddMeasure geometry geom_mline float measure_start float measure_end" +msgid "geometry ST_AddMeasure geometry geom_mline float8 measure_start float8 measure_end" msgstr "" #. Tag: para #: reference_lrs.xml:405 #, no-c-format -msgid "Return a derived geometry with measure elements linearly interpolated between the start and end points. If the geometry has no measure dimension, one is added. If the geometry has a measure dimension, it is over-written with new values. Only LINESTRINGS and MULTILINESTRINGS are supported." +msgid "Return a derived geometry with measure elements linearly interpolated between the start and end points. If the geometry has no measure dimension, one is added. If the geometry has a measure dimension, it is over-written with new values. Only LINESTRINGS and MULTILINESTRINGS are supported." msgstr "" #. Tag: para diff --git a/doc/po/templates/reference_management.xml.pot b/doc/po/templates/reference_management.xml.pot index 3cacca4ac..d118686a5 100644 --- a/doc/po/templates/reference_management.xml.pot +++ b/doc/po/templates/reference_management.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -724,7 +724,7 @@ msgstr "" #. Tag: para #: reference_management.xml:730 #, no-c-format -msgid "For backwards compatibility and for spatial needs such as tble inheritance where each child table may have different geometry type, the old check constraint behavior is still supported. If you need the old behavior, you need to pass in the new optional argument as false use_typmod=false. When this is done geometry columns will be created with no type modifiers but will have 3 constraints defined. In particular, this means that every geometry column belonging to a table has at least three constraints:" +msgid "For backwards compatibility and for spatial needs such as table inheritance where each child table may have different geometry type, the old check constraint behavior is still supported. If you need the old behavior, you need to pass in the new optional argument as false use_typmod=false. When this is done geometry columns will be created with no type modifiers but will have 3 constraints defined. In particular, this means that every geometry column belonging to a table has at least three constraints:" msgstr "" #. Tag: para diff --git a/doc/po/templates/reference_measure.xml.pot b/doc/po/templates/reference_measure.xml.pot index 63b443f81..c9cf31561 100644 --- a/doc/po/templates/reference_measure.xml.pot +++ b/doc/po/templates/reference_measure.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -39,7 +39,7 @@ msgid "geometry ST_3DClosestPoint boolean ST_3DIntersects set postgis.backend = sfcgal; or at the database or system level. Database level can be done with ALTER DATABASE gisdb SET postgis.backend = sfcgal;." +msgstr "" + +#. Tag: para +#: reference_measure.xml:271 +#, no-c-format +msgid "&T_support;" +msgstr "" + +#. Tag: para +#: reference_measure.xml:273 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: ?" msgstr "" #. Tag: title -#: reference_measure.xml:272 reference_measure.xml:2127 reference_measure.xml:2176 +#: reference_measure.xml:276 reference_measure.xml:2139 reference_measure.xml:2191 #, no-c-format msgid "Geometry Examples" msgstr "" #. Tag: programlisting -#: reference_measure.xml:273 +#: reference_measure.xml:277 #, no-c-format msgid "" "SELECT ST_3DIntersects(pt, line), ST_Intersects(pt,line) \n" @@ -381,38 +393,55 @@ msgid "" "(1 row)" msgstr "" +#. Tag: title +#: reference_measure.xml:280 +#, no-c-format +msgid "TIN Examples" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:281 +#, 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" +msgstr "" + #. Tag: refname -#: reference_measure.xml:283 +#: reference_measure.xml:291 #, no-c-format msgid "ST_3DLongestLine" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:285 +#: reference_measure.xml:293 #, no-c-format msgid "Returns the 3-dimensional longest line between two geometries" msgstr "" #. Tag: funcprototype -#: reference_measure.xml:290 +#: reference_measure.xml:298 #, no-c-format msgid "geometry ST_3DLongestLine geometry g1 geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:305 +#: reference_measure.xml:313 #, 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." msgstr "" #. Tag: para -#: reference_measure.xml:323 +#: reference_measure.xml:331 #, no-c-format msgid "linestring and point -- both 3d and 2d longest line" msgstr "" #. Tag: programlisting -#: reference_measure.xml:324 +#: reference_measure.xml:332 #, no-c-format msgid "" "SELECT ST_AsEWKT(ST_3DLongestLine(line,pt)) AS lol3d_line_pt, \n" @@ -428,13 +457,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:328 +#: reference_measure.xml:336 #, no-c-format msgid "linestring and multipoint -- both 3d and 2d longest line" msgstr "" #. Tag: programlisting -#: reference_measure.xml:329 +#: reference_measure.xml:337 #, no-c-format msgid "" "SELECT ST_AsEWKT(ST_3DLongestLine(line,pt)) AS lol3d_line_pt, \n" @@ -450,13 +479,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:333 +#: reference_measure.xml:341 #, no-c-format msgid "Multilinestring and polygon both 3d and 2d longest line" msgstr "" #. Tag: programlisting -#: reference_measure.xml:334 +#: reference_measure.xml:342 #, no-c-format msgid "" "SELECT ST_AsEWKT(ST_3DLongestLine(poly, mline)) As lol3d,\n" @@ -470,37 +499,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:346 +#: reference_measure.xml:354 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_measure.xml:352 +#: reference_measure.xml:360 #, no-c-format msgid "ST_3DMaxDistance" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:354 +#: reference_measure.xml:362 #, no-c-format msgid "For geometry type Returns the 3-dimensional cartesian maximum distance (based on spatial ref) between two geometries in projected units." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:359 +#: reference_measure.xml:367 #, no-c-format msgid "float ST_3DMaxDistance geometry g1 geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:374 +#: reference_measure.xml:382 #, 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:387 +#: reference_measure.xml:395 #, 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" @@ -520,43 +549,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:393 +#: reference_measure.xml:401 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_measure.xml:398 +#: reference_measure.xml:406 #, no-c-format msgid "ST_3DShortestLine" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:400 +#: reference_measure.xml:408 #, no-c-format msgid "Returns the 3-dimensional shortest line between two geometries" msgstr "" #. Tag: funcprototype -#: reference_measure.xml:405 +#: reference_measure.xml:413 #, no-c-format msgid "geometry ST_3DShortestLine geometry g1 geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:420 +#: reference_measure.xml:428 #, 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." msgstr "" #. Tag: para -#: reference_measure.xml:442 +#: reference_measure.xml:450 #, no-c-format msgid "linestring and point -- both 3d and 2d shortest line" msgstr "" #. Tag: programlisting -#: reference_measure.xml:443 +#: reference_measure.xml:451 #, no-c-format msgid "" "SELECT ST_AsEWKT(ST_3DShortestLine(line,pt)) AS shl3d_line_pt, \n" @@ -572,13 +601,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:447 +#: reference_measure.xml:455 #, no-c-format msgid "linestring and multipoint -- both 3d and 2d shortest line" msgstr "" #. Tag: programlisting -#: reference_measure.xml:448 +#: reference_measure.xml:456 #, no-c-format msgid "" "SELECT ST_AsEWKT(ST_3DShortestLine(line,pt)) AS shl3d_line_pt, \n" @@ -594,13 +623,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:452 +#: reference_measure.xml:460 #, no-c-format msgid "Multilinestring and polygon both 3d and 2d shortest line" msgstr "" #. Tag: programlisting -#: reference_measure.xml:453 +#: reference_measure.xml:461 #, no-c-format msgid "" "SELECT ST_AsEWKT(ST_3DShortestLine(poly, mline)) As shl3d,\n" @@ -614,67 +643,73 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:465 +#: reference_measure.xml:473 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_measure.xml:470 +#: reference_measure.xml:478 #, no-c-format msgid "ST_Area" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:472 +#: reference_measure.xml:480 #, no-c-format -msgid "Returns the area of the surface if it is a polygon or multi-polygon. For \"geometry\" type area is in SRID units. For \"geography\" area is in square meters." +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." msgstr "" #. Tag: funcsynopsis -#: reference_measure.xml:476 +#: reference_measure.xml:484 #, no-c-format msgid " float ST_Area geometry g1 float ST_Area geography geog boolean use_spheroid=true " msgstr "" #. Tag: para -#: reference_measure.xml:492 +#: reference_measure.xml:500 #, no-c-format -msgid "Returns the area of the geometry if it is a polygon or multi-polygon. Return the area measurement of an ST_Surface or ST_MultiSurface value. For geometry Area is in the units of the srid. For geography area is in square meters and defaults to measuring about the spheroid of the geography (currently only WGS84). To measure around the faster but less accurate sphere -- ST_Area(geog,false)." +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)." msgstr "" #. Tag: para -#: reference_measure.xml:497 +#: reference_measure.xml:505 #, no-c-format msgid "Enhanced: 2.0.0 - support for 2D polyhedral surfaces was introduced." msgstr "" #. Tag: para -#: reference_measure.xml:498 reference_measure.xml:641 reference_measure.xml:1571 reference_measure.xml:1947 +#: reference_measure.xml:506 reference_measure.xml:1589 +#, no-c-format +msgid "Enhanced: 2.2.0 - measurement on spheroid performed with GeographicLib for improved accuracy and robustness." +msgstr "" + +#. Tag: para +#: reference_measure.xml:507 reference_measure.xml:651 reference_measure.xml:1581 reference_measure.xml:1959 #, no-c-format msgid "&sfs_compliant;" msgstr "" #. Tag: para -#: reference_measure.xml:499 +#: reference_measure.xml:508 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 8.1.2, 9.5.3" msgstr "" #. Tag: para -#: reference_measure.xml:501 +#: reference_measure.xml:510 #, no-c-format msgid "For polyhedral surfaces, only supports 2D polyhedral surfaces (not 2.5D). For 2.5D, may give a non-zero answer, but only for the faces that sit completely in XY plane." msgstr "" #. Tag: para -#: reference_measure.xml:508 +#: reference_measure.xml:517 #, no-c-format -msgid "Return area in square feet for a plot of Massachusetts land and multiply by conversion to get square meters. Note this is in square feet because 2249 is Mass State Plane Feet" +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" msgstr "" #. Tag: programlisting -#: reference_measure.xml:511 +#: reference_measure.xml:520 #, no-c-format msgid "" "SELECT ST_Area(the_geom) As sqft, ST_Area(the_geom)*POWER(0.3048,2) As sqm\n" @@ -687,13 +722,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:512 +#: reference_measure.xml:521 #, no-c-format -msgid "Return area square feet and transform to Massachusetts state plane meters (26986) to get square meters. Note this is in square feet because 2249 is Mass State Plane Feet and transformed area is in square meters since 26986 is state plane mass meters" +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" msgstr "" #. Tag: programlisting -#: reference_measure.xml:515 +#: reference_measure.xml:524 #, no-c-format msgid "" "SELECT ST_Area(the_geom) As sqft, ST_Area(ST_Transform(the_geom,26986)) As sqm\n" @@ -706,13 +741,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:517 +#: reference_measure.xml:526 #, 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." +msgid "Return area square feet and square meters using geography data type. Note that we transform to our geometry to geography (before you can do that make sure your geometry is in WGS 84 long lat 4326). Geography always measures in meters. This is just for demonstration to compare. Normally your table will be stored in geography data type already." msgstr "" #. Tag: programlisting -#: reference_measure.xml:520 +#: reference_measure.xml:529 #, 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" @@ -725,9 +760,9 @@ msgid "" " )\n" " )\n" " ) As foo(the_geog);\n" - " sqft_spheroid | sqft_sphere | sqm_spheroid\n" - "-----------------+------------------+------------------\n" - "928.684405217197 | 927.186481558724 | 86.2776044452694\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" @@ -735,76 +770,83 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:524 +#: reference_measure.xml:533 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_measure.xml:530 +#: reference_measure.xml:539 #, no-c-format msgid "ST_Azimuth" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:532 +#: reference_measure.xml:541 #, no-c-format msgid "Returns the north-based azimuth as the angle in radians measured clockwise from the vertical on pointA to pointB." msgstr "" #. Tag: funcsynopsis -#: reference_measure.xml:535 +#: reference_measure.xml:544 #, no-c-format msgid " float ST_Azimuth geometry pointA geometry pointB float ST_Azimuth geography pointA geography pointB " msgstr "" #. Tag: para -#: reference_measure.xml:551 +#: reference_measure.xml:560 +#, 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." +msgstr "" + +#. Tag: para +#: reference_measure.xml:562 #, 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 north-based and is measured clockwise: North = 0; East = PI/2; South = PI; West = 3PI/2." +msgid "For the geography type, the forward azimuth is solved as part of the inverse geodesic problem." msgstr "" #. Tag: para -#: reference_measure.xml:554 +#: reference_measure.xml:563 #, no-c-format -msgid "The Azimuth is mathematical concept defined as the angle, in this case measured in radian, between a reference plane and a point." +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:557 +#: reference_measure.xml:566 #, no-c-format msgid "Availability: 1.1.0" msgstr "" #. Tag: para -#: reference_measure.xml:558 +#: reference_measure.xml:567 #, no-c-format msgid "Enhanced: 2.0.0 support for geography was introduced." msgstr "" #. Tag: para -#: reference_measure.xml:559 +#: reference_measure.xml:568 +#, no-c-format +msgid "Enhanced: 2.2.0 measurement on spheroid performed with GeographicLib for improved accuracy and robustness." +msgstr "" + +#. Tag: para +#: reference_measure.xml:569 #, 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." msgstr "" #. Tag: para -#: reference_measure.xml:565 +#: reference_measure.xml:575 #, no-c-format msgid "Geometry Azimuth in degrees" msgstr "" #. Tag: programlisting -#: reference_measure.xml:566 +#: reference_measure.xml:576 #, no-c-format msgid "" - "SELECT ST_Azimuth(ST_Point(25,45), ST_Point(75,100))/(2*pi())*360 as degA_B,\n" - " ST_Azimuth(ST_Point(75,100), ST_Point(25,45))/(2*pi())*360 As degB_A;\n" - " \n" - "-- NOTE easier to remember syntax using PostgreSQL built-in degrees function --\n" - "-- Both yield same answer --\n" - "SELECT degrees( ST_Azimuth(ST_Point(25,45), ST_Point(75,100)) ) as degA_B,\n" - " degrees( ST_Azimuth(ST_Point(75,100), ST_Point(25,45)) ) As degB_A;\n" + "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" @@ -812,97 +854,97 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:576 +#: reference_measure.xml:586 #, no-c-format msgid "Green: the start Point(25,45) with its vertical. Yellow: degA_B as the path to travel (azimuth)." msgstr "" #. Tag: para -#: reference_measure.xml:585 +#: reference_measure.xml:595 #, no-c-format msgid "Green: the start Point(75,100) with its vertical. Yellow: degB_A as the path to travel (azimuth)." msgstr "" #. Tag: para -#: reference_measure.xml:596 +#: reference_measure.xml:606 #, no-c-format msgid ", , , PostgreSQL Math Functions" msgstr "" #. Tag: refname -#: reference_measure.xml:603 +#: reference_measure.xml:613 #, no-c-format msgid "ST_Centroid" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:605 +#: reference_measure.xml:615 #, no-c-format msgid "Returns the geometric center of a geometry." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:610 +#: reference_measure.xml:620 #, no-c-format msgid "geometry ST_Centroid geometry g1" msgstr "" #. Tag: para -#: reference_measure.xml:622 +#: reference_measure.xml:632 #, 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." msgstr "" #. Tag: para -#: reference_measure.xml:634 +#: reference_measure.xml:644 #, 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:638 +#: reference_measure.xml:648 #, no-c-format msgid "Computation will be more accurate if performed by the GEOS module (enabled at compile time)." msgstr "" #. Tag: para -#: reference_measure.xml:642 +#: reference_measure.xml:652 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 8.1.4, 9.5.5" msgstr "" #. Tag: para -#: reference_measure.xml:648 +#: reference_measure.xml:658 #, no-c-format msgid "In each of the following illustrations, the blue dot represents the centroid of the source geometry." msgstr "" #. Tag: para -#: reference_measure.xml:661 +#: reference_measure.xml:671 #, no-c-format msgid "Centroid of a MULTIPOINT" msgstr "" #. Tag: para -#: reference_measure.xml:672 +#: reference_measure.xml:682 #, no-c-format msgid "Centroid of a LINESTRING" msgstr "" #. Tag: para -#: reference_measure.xml:685 +#: reference_measure.xml:695 #, no-c-format msgid "Centroid of a POLYGON" msgstr "" #. Tag: para -#: reference_measure.xml:696 +#: reference_measure.xml:706 #, no-c-format msgid "Centroid of a GEOMETRYCOLLECTION" msgstr "" #. Tag: programlisting -#: reference_measure.xml:705 +#: reference_measure.xml:715 #, 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" @@ -913,49 +955,49 @@ msgid "" msgstr "" #. Tag: refname -#: reference_measure.xml:717 +#: reference_measure.xml:727 #, no-c-format msgid "ST_ClosestPoint" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:719 +#: reference_measure.xml:729 #, 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." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:725 +#: reference_measure.xml:735 #, no-c-format msgid "geometry ST_ClosestPoint geometry g1 geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:740 +#: reference_measure.xml:750 #, 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." msgstr "" #. Tag: para -#: reference_measure.xml:743 +#: reference_measure.xml:753 #, no-c-format msgid "If you have a 3D Geometry, you may prefer to use ." msgstr "" #. Tag: para -#: reference_measure.xml:744 reference_measure.xml:1699 reference_measure.xml:1852 reference_measure.xml:2448 reference_measure.xml:3027 +#: reference_measure.xml:754 reference_measure.xml:1710 reference_measure.xml:1864 reference_measure.xml:2419 reference_measure.xml:2993 #, no-c-format msgid "Availability: 1.5.0" msgstr "" #. Tag: para -#: reference_measure.xml:758 +#: reference_measure.xml:768 #, no-c-format msgid "Closest between point and linestring is the point itself, but closest point between a linestring and point is the point on line string that is closest." msgstr "" #. Tag: programlisting -#: reference_measure.xml:762 +#: reference_measure.xml:772 #, no-c-format msgid "" "SELECT ST_AsText(ST_ClosestPoint(pt,line)) AS cp_pt_line, \n" @@ -971,13 +1013,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:770 +#: reference_measure.xml:780 #, no-c-format msgid "closest point on polygon A to polygon B" msgstr "" #. Tag: programlisting -#: reference_measure.xml:773 +#: reference_measure.xml:783 #, no-c-format msgid "" "SELECT ST_AsText(\n" @@ -993,133 +1035,133 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:785 +#: reference_measure.xml:795 #, no-c-format msgid ",, , , " msgstr "" #. Tag: refname -#: reference_measure.xml:791 +#: reference_measure.xml:801 #, no-c-format msgid "ST_Contains" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:793 +#: reference_measure.xml:803 #, no-c-format msgid "Returns true if and only if no points of B lie in the exterior of A, and at least one point of the interior of B lies in the interior of A." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:798 +#: reference_measure.xml:808 #, no-c-format msgid "boolean ST_Contains geometry geomA geometry geomB" msgstr "" #. Tag: para -#: reference_measure.xml:813 +#: reference_measure.xml:823 #, 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_measure.xml:817 +#: reference_measure.xml:827 #, no-c-format msgid "Returns TRUE if geometry B is completely inside geometry A. For this function to make sense, the source geometries must both be of the same coordinate projection, having the same SRID. ST_Contains is the inverse of ST_Within. So ST_Contains(A,B) implies ST_Within(B,A) except in the case of invalid geometries where the result is always false regardless or not defined." msgstr "" #. Tag: para -#: reference_measure.xml:822 reference_measure.xml:1049 reference_measure.xml:1131 reference_measure.xml:1496 reference_measure.xml:2579 reference_measure.xml:2932 reference_measure.xml:3249 +#: reference_measure.xml:832 reference_measure.xml:1059 reference_measure.xml:1141 reference_measure.xml:1506 reference_measure.xml:2550 reference_measure.xml:2898 reference_measure.xml:3215 #, no-c-format msgid "Performed by the GEOS module" msgstr "" #. Tag: para -#: reference_measure.xml:825 reference_measure.xml:987 reference_measure.xml:1052 reference_measure.xml:1134 reference_measure.xml:1238 reference_measure.xml:1493 reference_measure.xml:3130 reference_measure.xml:3252 +#: reference_measure.xml:835 reference_measure.xml:997 reference_measure.xml:1062 reference_measure.xml:1144 reference_measure.xml:1248 reference_measure.xml:1503 reference_measure.xml:3096 reference_measure.xml:3218 #, no-c-format msgid "Do not call with a GEOMETRYCOLLECTION as an argument" msgstr "" #. Tag: para -#: reference_measure.xml:829 reference_measure.xml:991 reference_measure.xml:1060 reference_measure.xml:1138 reference_measure.xml:3256 +#: reference_measure.xml:839 reference_measure.xml:1001 reference_measure.xml:1070 reference_measure.xml:1148 reference_measure.xml:3222 #, no-c-format msgid "Do not use this function with invalid geometries. You will get unexpected results." msgstr "" #. Tag: para -#: reference_measure.xml:832 +#: reference_measure.xml:842 #, no-c-format msgid "This function call will automatically include a bounding box comparison that will make use of any indexes that are available on the geometries. To avoid index use, use the function _ST_Contains." msgstr "" #. Tag: para -#: reference_measure.xml:837 reference_measure.xml:1071 reference_measure.xml:1146 reference_measure.xml:1502 reference_measure.xml:2117 reference_measure.xml:2588 reference_measure.xml:3264 +#: reference_measure.xml:847 reference_measure.xml:1081 reference_measure.xml:1156 reference_measure.xml:1512 reference_measure.xml:2129 reference_measure.xml:2559 reference_measure.xml:3230 #, no-c-format msgid "NOTE: this is the \"allowable\" version that returns a boolean, not an integer." msgstr "" #. Tag: para -#: reference_measure.xml:840 +#: reference_measure.xml:850 #, no-c-format msgid "&sfs_compliant; s2.1.1.2 // s2.1.13.3 - same as within(geometry B, geometry A)" msgstr "" #. Tag: para -#: reference_measure.xml:842 +#: reference_measure.xml:852 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.31" msgstr "" #. Tag: para -#: reference_measure.xml:844 reference_measure.xml:1075 reference_measure.xml:1150 +#: reference_measure.xml:854 reference_measure.xml:1085 reference_measure.xml:1160 #, 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: para -#: reference_measure.xml:851 +#: reference_measure.xml:861 #, no-c-format msgid "The ST_Contains predicate returns TRUE in all the following illustrations." msgstr "" #. Tag: para -#: reference_measure.xml:863 +#: reference_measure.xml:873 #, no-c-format msgid "LINESTRING / MULTIPOINT" msgstr "" #. Tag: para -#: reference_measure.xml:873 reference_measure.xml:3208 +#: reference_measure.xml:883 reference_measure.xml:3174 #, no-c-format msgid "POLYGON / POINT" msgstr "" #. Tag: para -#: reference_measure.xml:884 reference_measure.xml:924 reference_measure.xml:3177 +#: reference_measure.xml:894 reference_measure.xml:934 reference_measure.xml:3143 #, no-c-format msgid "POLYGON / LINESTRING" msgstr "" #. Tag: para -#: reference_measure.xml:894 reference_measure.xml:2625 reference_measure.xml:3157 reference_measure.xml:3167 +#: reference_measure.xml:904 reference_measure.xml:2596 reference_measure.xml:3123 reference_measure.xml:3133 #, no-c-format msgid "POLYGON / POLYGON" msgstr "" #. Tag: para -#: reference_measure.xml:902 +#: reference_measure.xml:912 #, no-c-format msgid "The ST_Contains predicate returns FALSE in all the following illustrations." msgstr "" #. Tag: para -#: reference_measure.xml:914 +#: reference_measure.xml:924 #, no-c-format msgid "POLYGON / MULTIPOINT" msgstr "" #. Tag: programlisting -#: reference_measure.xml:932 +#: reference_measure.xml:942 #, no-c-format msgid "" "-- A circle within a circle\n" @@ -1153,73 +1195,73 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:937 +#: reference_measure.xml:947 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_measure.xml:943 +#: reference_measure.xml:953 #, no-c-format msgid "ST_ContainsProperly" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:945 +#: reference_measure.xml:955 #, no-c-format msgid "Returns true if B intersects the interior of A but not the boundary (or exterior). A does not contain properly itself, but does contain itself." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:950 +#: reference_measure.xml:960 #, no-c-format msgid "boolean ST_ContainsProperly geometry geomA geometry geomB" msgstr "" #. Tag: para -#: reference_measure.xml:965 +#: reference_measure.xml:975 #, no-c-format msgid "Returns true if B intersects the interior of A but not the boundary (or exterior)." msgstr "" #. Tag: para -#: reference_measure.xml:967 +#: reference_measure.xml:977 #, no-c-format msgid "A does not contain properly itself, but does contain itself." msgstr "" #. Tag: para -#: reference_measure.xml:968 +#: reference_measure.xml:978 #, 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_measure.xml:972 +#: reference_measure.xml:982 #, 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_measure.xml:974 +#: reference_measure.xml:984 #, 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:984 +#: reference_measure.xml:994 #, no-c-format msgid "Availability: 1.4.0 - requires GEOS >= 3.1.0." msgstr "" #. Tag: para -#: reference_measure.xml:994 +#: reference_measure.xml:1004 #, no-c-format msgid "This function call will automatically include a bounding box comparison that will make use of any indexes that are available on the geometries. To avoid index use, use the function _ST_ContainsProperly." msgstr "" #. Tag: programlisting -#: reference_measure.xml:1003 +#: reference_measure.xml:1013 #, no-c-format msgid "" "--a circle within a circle\n" @@ -1252,73 +1294,73 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:1008 +#: reference_measure.xml:1018 #, no-c-format msgid ", , , , , , , " msgstr "" #. Tag: refname -#: reference_measure.xml:1014 +#: reference_measure.xml:1024 #, no-c-format msgid "ST_Covers" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1016 +#: reference_measure.xml:1026 #, no-c-format msgid "Returns 1 (TRUE) if no point in Geometry B is outside Geometry A" msgstr "" #. Tag: funcsynopsis -#: reference_measure.xml:1021 +#: reference_measure.xml:1031 #, no-c-format msgid " boolean ST_Covers geometry geomA geometry geomB boolean ST_Covers geography geogpolyA geography geogpointB " msgstr "" #. Tag: para -#: reference_measure.xml:1046 +#: reference_measure.xml:1056 #, no-c-format msgid "Returns 1 (TRUE) if no point in Geometry/Geography B is outside Geometry/Geography A" msgstr "" #. Tag: para -#: reference_measure.xml:1056 +#: reference_measure.xml:1066 #, no-c-format msgid "For geography only Polygon covers point is supported." msgstr "" #. Tag: para -#: reference_measure.xml:1063 +#: reference_measure.xml:1073 #, no-c-format msgid "This function call will automatically include a bounding box comparison that will make use of any indexes that are available on the geometries. To avoid index use, use the function _ST_Covers." msgstr "" #. Tag: para -#: reference_measure.xml:1068 reference_measure.xml:1140 +#: reference_measure.xml:1078 reference_measure.xml:1150 #, no-c-format msgid "Availability: 1.2.2 - requires GEOS >= 3.0" msgstr "" #. Tag: para -#: reference_measure.xml:1069 +#: reference_measure.xml:1079 #, no-c-format msgid "Availability: 1.5 - support for geography was introduced." msgstr "" #. Tag: para -#: reference_measure.xml:1074 reference_measure.xml:1149 +#: reference_measure.xml:1084 reference_measure.xml:1159 #, no-c-format msgid "Not an OGC standard, but Oracle has it too." msgstr "" #. Tag: para -#: reference_measure.xml:1081 +#: reference_measure.xml:1091 #, no-c-format msgid "Geometry example" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1082 +#: reference_measure.xml:1092 #, no-c-format msgid "" "--a circle covering a circle\n" @@ -1336,13 +1378,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:1083 +#: reference_measure.xml:1093 #, no-c-format msgid "Geeography Example" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1084 +#: reference_measure.xml:1094 #, no-c-format msgid "" "-- a point with a 300 meter buffer compared to a point, a point and its 10 meter buffer\n" @@ -1357,43 +1399,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:1089 +#: reference_measure.xml:1099 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_measure.xml:1095 +#: reference_measure.xml:1105 #, no-c-format msgid "ST_CoveredBy" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1097 +#: reference_measure.xml:1107 #, no-c-format msgid "Returns 1 (TRUE) if no point in Geometry/Geography A is outside Geometry/Geography B" msgstr "" #. Tag: funcsynopsis -#: reference_measure.xml:1102 +#: reference_measure.xml:1112 #, no-c-format msgid " boolean ST_CoveredBy geometry geomA geometry geomB boolean ST_CoveredBy geography geogA geography geogB " msgstr "" #. Tag: para -#: reference_measure.xml:1128 +#: reference_measure.xml:1138 #, no-c-format msgid "Returns 1 (TRUE) if no point in Geometry/Geography A is outside Geometry/Geography B" msgstr "" #. Tag: para -#: reference_measure.xml:1141 +#: reference_measure.xml:1151 #, 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:1156 +#: reference_measure.xml:1166 #, no-c-format msgid "" "--a circle coveredby a circle\n" @@ -1411,133 +1453,133 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:1161 +#: reference_measure.xml:1171 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_measure.xml:1167 +#: reference_measure.xml:1177 #, no-c-format msgid "ST_Crosses" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1169 +#: reference_measure.xml:1179 #, no-c-format msgid "Returns TRUE if the supplied geometries have some, but not all, interior points in common." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:1175 +#: reference_measure.xml:1185 #, no-c-format msgid "boolean ST_Crosses geometry g1 geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:1188 +#: reference_measure.xml:1198 #, 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 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_measure.xml:1197 +#: reference_measure.xml:1207 #, no-c-format msgid "In mathematical terms, this is expressed as:" msgstr "" #. Tag: remark -#: reference_measure.xml:1199 +#: reference_measure.xml:1209 #, no-c-format msgid "TODO: Insert appropriate MathML markup here or use a gif. Simple HTML markup does not work well in both IE and Firefox." msgstr "" #. Tag: para -#: reference_measure.xml:1210 +#: reference_measure.xml:1220 #, no-c-format msgid "The DE-9IM Intersection Matrix for the two geometries is:" msgstr "" #. Tag: para -#: reference_measure.xml:1214 +#: reference_measure.xml:1224 #, no-c-format msgid "T*T****** (for Point/Line, Point/Area, and Line/Area situations)" msgstr "" #. Tag: para -#: reference_measure.xml:1219 +#: reference_measure.xml:1229 #, no-c-format msgid "T*****T** (for Line/Point, Area/Point, and Area/Line situations)" msgstr "" #. Tag: para -#: reference_measure.xml:1224 +#: reference_measure.xml:1234 #, no-c-format msgid "0******** (for Line/Line situations)" msgstr "" #. Tag: para -#: reference_measure.xml:1228 +#: reference_measure.xml:1238 #, no-c-format msgid "For any other combination of dimensions this predicate returns false." msgstr "" #. Tag: para -#: reference_measure.xml:1231 +#: reference_measure.xml:1241 #, 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:1247 +#: reference_measure.xml:1257 #, no-c-format msgid "&sfs_compliant; s2.1.13.3" msgstr "" #. Tag: para -#: reference_measure.xml:1248 +#: reference_measure.xml:1258 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.29" msgstr "" #. Tag: para -#: reference_measure.xml:1254 reference_measure.xml:2597 +#: reference_measure.xml:1264 reference_measure.xml:2568 #, no-c-format msgid "The following illustrations all return TRUE." msgstr "" #. Tag: para -#: reference_measure.xml:1266 +#: reference_measure.xml:1276 #, no-c-format msgid "MULTIPOINT / LINESTRING" msgstr "" #. Tag: para -#: reference_measure.xml:1276 +#: reference_measure.xml:1286 #, no-c-format msgid "MULTIPOINT / POLYGON" msgstr "" #. Tag: para -#: reference_measure.xml:1288 +#: reference_measure.xml:1298 #, no-c-format msgid "LINESTRING / POLYGON" msgstr "" #. Tag: para -#: reference_measure.xml:1298 reference_measure.xml:2617 reference_measure.xml:3188 reference_measure.xml:3198 +#: reference_measure.xml:1308 reference_measure.xml:2588 reference_measure.xml:3154 reference_measure.xml:3164 #, no-c-format msgid "LINESTRING / LINESTRING" msgstr "" #. Tag: para -#: reference_measure.xml:1306 +#: reference_measure.xml:1316 #, 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:1314 +#: reference_measure.xml:1324 #, no-c-format msgid "" "CREATE TABLE roads (\n" @@ -1548,7 +1590,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1318 +#: reference_measure.xml:1328 #, no-c-format msgid "" "CREATE TABLE highways (\n" @@ -1559,13 +1601,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:1325 +#: reference_measure.xml:1335 #, 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:1329 +#: reference_measure.xml:1339 #, no-c-format msgid "" "SELECT roads.id\n" @@ -1574,91 +1616,91 @@ msgid "" msgstr "" #. Tag: refname -#: reference_measure.xml:1336 +#: reference_measure.xml:1346 #, no-c-format msgid "ST_LineCrossingDirection" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1338 +#: reference_measure.xml:1348 #, 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:1343 +#: reference_measure.xml:1353 #, no-c-format msgid "integer ST_LineCrossingDirection geometry linestringA geometry linestringB" msgstr "" #. Tag: para -#: reference_measure.xml:1354 +#: reference_measure.xml:1364 #, 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:1355 +#: reference_measure.xml:1365 #, no-c-format msgid "Definition of integer constants is as follows:" msgstr "" #. Tag: para -#: reference_measure.xml:1358 +#: reference_measure.xml:1368 #, no-c-format msgid "0: LINE NO CROSS" msgstr "" #. Tag: para -#: reference_measure.xml:1361 +#: reference_measure.xml:1371 #, no-c-format msgid "-1: LINE CROSS LEFT" msgstr "" #. Tag: para -#: reference_measure.xml:1364 +#: reference_measure.xml:1374 #, no-c-format msgid "1: LINE CROSS RIGHT" msgstr "" #. Tag: para -#: reference_measure.xml:1367 +#: reference_measure.xml:1377 #, no-c-format msgid "-2: LINE MULTICROSS END LEFT" msgstr "" #. Tag: para -#: reference_measure.xml:1370 +#: reference_measure.xml:1380 #, no-c-format msgid "2: LINE MULTICROSS END RIGHT" msgstr "" #. Tag: para -#: reference_measure.xml:1373 +#: reference_measure.xml:1383 #, no-c-format msgid "-3: LINE MULTICROSS END SAME FIRST LEFT" msgstr "" #. Tag: para -#: reference_measure.xml:1376 +#: reference_measure.xml:1386 #, no-c-format msgid "3: LINE MULTICROSS END SAME FIRST RIGHT" msgstr "" #. Tag: para -#: reference_measure.xml:1380 +#: reference_measure.xml:1390 #, no-c-format msgid "Availability: 1.4" msgstr "" #. Tag: para -#: reference_measure.xml:1398 +#: reference_measure.xml:1408 #, 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:1402 +#: reference_measure.xml:1412 #, no-c-format msgid "" "SELECT ST_LineCrossingDirection(foo.line1, foo.line2) As l1_cross_l2 ,\n" @@ -1675,13 +1717,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:1412 reference_measure.xml:1426 reference_measure.xml:1440 +#: reference_measure.xml:1422 reference_measure.xml:1436 reference_measure.xml:1450 #, 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:1416 +#: reference_measure.xml:1426 #, no-c-format msgid "" "SELECT ST_LineCrossingDirection(foo.line1, foo.line2) As l1_cross_l2 ,\n" @@ -1698,7 +1740,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1430 +#: reference_measure.xml:1440 #, no-c-format msgid "" "SELECT\n" @@ -1716,7 +1758,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1444 +#: reference_measure.xml:1454 #, no-c-format msgid "" "SELECT ST_LineCrossingDirection(foo.line1, foo.line2) As l1_cross_l2 ,\n" @@ -1732,7 +1774,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1452 +#: reference_measure.xml:1462 #, no-c-format msgid "" "SELECT s1.gid, s2.gid, ST_LineCrossingDirection(s1.the_geom, s2.the_geom)\n" @@ -1741,49 +1783,49 @@ msgid "" msgstr "" #. Tag: refname -#: reference_measure.xml:1465 +#: reference_measure.xml:1475 #, no-c-format msgid "ST_Disjoint" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1467 +#: reference_measure.xml:1477 #, 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:1473 +#: reference_measure.xml:1483 #, no-c-format msgid "boolean ST_Disjoint geometry A geometry B " msgstr "" #. Tag: para -#: reference_measure.xml:1488 +#: reference_measure.xml:1498 #, 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:1498 +#: reference_measure.xml:1508 #, no-c-format msgid "This function call does not use indexes" msgstr "" #. Tag: para -#: reference_measure.xml:1505 +#: reference_measure.xml:1515 #, 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:1507 +#: reference_measure.xml:1517 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.26" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1512 +#: reference_measure.xml:1522 #, no-c-format msgid "" "SELECT ST_Disjoint('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 2 )'::geometry);\n" @@ -1799,73 +1841,73 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:1517 +#: reference_measure.xml:1527 #, no-c-format msgid "ST_Intersects" msgstr "" #. Tag: refname -#: reference_measure.xml:1523 +#: reference_measure.xml:1533 #, no-c-format msgid "ST_Distance" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1525 +#: reference_measure.xml:1535 #, no-c-format -msgid "For geometry type Returns the 2-dimensional cartesian minimum distance (based on spatial ref) between two geometries in projected units. For geography type defaults to return spheroidal minimum distance between two geographies in meters." +msgid "For geometry type Returns the 2D Cartesian distance between two geometries in projected units (based on spatial ref). For geography type defaults to return minimum geodesic distance between two geographies in meters." msgstr "" #. Tag: funcsynopsis -#: reference_measure.xml:1529 +#: reference_measure.xml:1539 #, 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:1567 +#: reference_measure.xml:1577 #, no-c-format -msgid "For geometry type returns the 2-dimensional minimum cartesian distance between two geometries in projected units (spatial ref units). For geography type defaults to return the minimum distance around WGS 84 spheroid between two geographies in meters. Pass in false to return answer in sphere instead of spheroid." +msgid "For geometry type returns the minimum 2D Cartesian distance between two geometries in projected units (spatial ref units). For geography 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:1572 +#: reference_measure.xml:1582 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.23" msgstr "" #. Tag: para -#: reference_measure.xml:1573 reference_measure.xml:2039 +#: reference_measure.xml:1583 reference_measure.xml:2051 #, no-c-format msgid "&curve_support;" msgstr "" #. Tag: para -#: reference_measure.xml:1576 +#: reference_measure.xml:1586 #, 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:1577 reference_measure.xml:1949 +#: reference_measure.xml:1587 #, no-c-format -msgid "Enhanced: 2.1.0 improved speed for geography. See Making Geography faster for details." +msgid "Enhanced: 2.1.0 improved speed for geography. See Making Geography faster for details." msgstr "" #. Tag: para -#: reference_measure.xml:1578 +#: reference_measure.xml:1588 #, no-c-format msgid "Enhanced: 2.1.0 - support for curved geometries was introduced." msgstr "" #. Tag: title -#: reference_measure.xml:1582 +#: reference_measure.xml:1593 #, no-c-format msgid "Basic Geometry Examples" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1584 +#: reference_measure.xml:1595 #, no-c-format msgid "" "--Geometry example - units in planar degrees 4326 is WGS 84 long lat unit=degrees\n" @@ -1898,13 +1940,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_measure.xml:1587 reference_measure.xml:2131 reference_measure.xml:2182 +#: reference_measure.xml:1598 reference_measure.xml:2143 reference_measure.xml:2197 #, no-c-format msgid "Geography Examples" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1588 +#: reference_measure.xml:1599 #, no-c-format msgid "" "-- same as geometry example but note units in meters - use sphere for slightly faster less accurate\n" @@ -1920,67 +1962,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:1596 +#: reference_measure.xml:1607 #, no-c-format -msgid ", , , , , " +msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_measure.xml:1602 +#: reference_measure.xml:1613 #, no-c-format msgid "ST_HausdorffDistance" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1604 +#: reference_measure.xml:1615 #, 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:1609 +#: reference_measure.xml:1620 #, 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:1637 +#: reference_measure.xml:1648 #, 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:1640 +#: reference_measure.xml:1651 #, 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:1645 +#: reference_measure.xml:1656 #, 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:1650 +#: reference_measure.xml:1661 #, 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:1655 +#: reference_measure.xml:1666 #, no-c-format msgid "Availability: 1.5.0 - requires GEOS >= 3.2.0" msgstr "" #. Tag: para -#: reference_measure.xml:1661 +#: reference_measure.xml:1672 #, 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:1663 +#: reference_measure.xml:1674 #, no-c-format msgid "" "SELECT DISTINCT ON(buildings.gid) buildings.gid, parcels.parcel_id \n" @@ -1989,7 +2031,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1665 +#: reference_measure.xml:1676 #, no-c-format msgid "" "postgis=# SELECT ST_HausdorffDistance(\n" @@ -2002,7 +2044,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1666 +#: reference_measure.xml:1677 #, 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" @@ -2013,37 +2055,37 @@ msgid "" msgstr "" #. Tag: refname -#: reference_measure.xml:1673 +#: reference_measure.xml:1684 #, no-c-format msgid "ST_MaxDistance" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1675 +#: reference_measure.xml:1686 #, no-c-format msgid "Returns the 2-dimensional largest distance between two geometries in projected units." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:1681 +#: reference_measure.xml:1692 #, no-c-format msgid "float ST_MaxDistance geometry g1 geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:1694 +#: reference_measure.xml:1705 #, 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:1704 +#: reference_measure.xml:1715 #, no-c-format msgid "Basic furthest distance the point is to any part of the line" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1705 +#: reference_measure.xml:1716 #, no-c-format msgid "" "postgis=# SELECT ST_MaxDistance('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 2 )'::geometry);\n" @@ -2060,52 +2102,52 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:1711 +#: reference_measure.xml:1722 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_measure.xml:1717 +#: reference_measure.xml:1728 #, no-c-format -msgid "ST_Distance_Sphere" +msgid "ST_DistanceSphere" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1719 +#: reference_measure.xml:1730 #, no-c-format -msgid "Returns minimum distance in meters between two lon/lat geometries. Uses a spherical earth and radius of 6370986 meters. Faster than ST_Distance_Spheroid , but less accurate. PostGIS versions prior to 1.5 only implemented for points." +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:1727 +#: reference_measure.xml:1739 #, no-c-format -msgid "float ST_Distance_Sphere geometry geomlonlatA geometry geomlonlatB" +msgid "float ST_DistanceSphere geometry geomlonlatA geometry geomlonlatB" msgstr "" #. Tag: para -#: reference_measure.xml:1738 +#: reference_measure.xml:1750 #, no-c-format -msgid "Returns minimum distance in meters between two lon/lat points. Uses a spherical earth and radius of 6370986 meters. Faster than , but less accurate. PostGIS Versions prior to 1.5 only implemented for points." +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:1743 +#: reference_measure.xml:1756 reference_measure.xml:1805 #, no-c-format -msgid "This function currently does not look at the SRID of a geometry and will always assume its in WGS 84 long lat. Prior versions of this function only support points." +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:1746 reference_measure.xml:1794 +#: reference_measure.xml:1757 #, no-c-format -msgid "Availability: 1.5 - support for other geometry types besides points was introduced. Prior versions only work with points." +msgid "Changed: 2.2.0 In prior versions this used to be called ST_Distance_Sphere" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1753 +#: reference_measure.xml:1764 #, no-c-format msgid "" - "SELECT round(CAST(ST_Distance_Sphere(ST_Centroid(the_geom), ST_GeomFromText('POINT(-118 38)',4326)) As numeric),2) As dist_meters,\n" + "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" @@ -2119,49 +2161,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:1760 +#: reference_measure.xml:1771 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:1766 +#: reference_measure.xml:1777 #, no-c-format -msgid "ST_Distance_Spheroid" +msgid "ST_DistanceSpheroid" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1768 +#: reference_measure.xml:1779 #, 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:1775 +#: reference_measure.xml:1786 #, no-c-format -msgid "float ST_Distance_Spheroid geometry geomlonlatA geometry geomlonlatB spheroid measurement_spheroid" +msgid "float ST_DistanceSpheroid geometry geomlonlatA geometry geomlonlatB spheroid measurement_spheroid" msgstr "" #. Tag: para -#: reference_measure.xml:1787 +#: reference_measure.xml:1798 #, 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:1791 +#: reference_measure.xml:1802 #, 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:1806 +#, 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:1801 +#: reference_measure.xml:1813 #, no-c-format msgid "" "SELECT round(CAST(\n" - " ST_Distance_Spheroid(ST_Centroid(the_geom), ST_GeomFromText('POINT(-118 38)',4326), 'SPHEROID[\"WGS 84\",6378137,298.257223563]')\n" + " 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_Distance_Sphere(ST_Centroid(the_geom), ST_GeomFromText('POINT(-118 38)',4326)) As numeric),2) As dist_meters_sphere,\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" @@ -2172,37 +2220,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:1808 +#: reference_measure.xml:1820 #, no-c-format -msgid ", " +msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:1814 +#: reference_measure.xml:1826 #, no-c-format msgid "ST_DFullyWithin" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1816 +#: reference_measure.xml:1828 #, 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:1822 +#: reference_measure.xml:1834 #, no-c-format msgid "boolean ST_DFullyWithin geometry g1 geometry g2 double precision distance" msgstr "" #. Tag: para -#: reference_measure.xml:1840 +#: reference_measure.xml:1852 #, 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:1857 +#: reference_measure.xml:1869 #, 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" @@ -2215,73 +2263,79 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:1863 +#: reference_measure.xml:1875 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:1869 +#: reference_measure.xml:1881 #, no-c-format msgid "ST_DWithin" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1871 +#: reference_measure.xml:1883 #, 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:1877 +#: reference_measure.xml:1889 #, 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:1922 +#: reference_measure.xml:1934 #, no-c-format msgid "Returns true if the geometries are within the specified distance of one another." msgstr "" #. Tag: para -#: reference_measure.xml:1924 +#: reference_measure.xml:1936 #, no-c-format msgid "For Geometries: The distance is specified in units defined by the spatial reference system of the geometries. For this function to make sense, the source geometries must both be of the same coordinate projection, having the same SRID." msgstr "" #. Tag: para -#: reference_measure.xml:1929 +#: reference_measure.xml:1941 #, no-c-format -msgid "For geography units are in meters and measurement is defaulted to use_spheroid=true (measure around WGS 84 spheroid), for faster check, use_spheroid=false to measure along sphere." +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:1939 +#: reference_measure.xml:1951 #, 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:1945 +#: reference_measure.xml:1957 #, no-c-format msgid "Use ST_3DDWithin if you have 3D geometries." msgstr "" #. Tag: para -#: reference_measure.xml:1948 +#: reference_measure.xml:1960 #, no-c-format msgid "Availability: 1.5.0 support for geography was introduced" msgstr "" #. Tag: para -#: reference_measure.xml:1950 +#: reference_measure.xml:1961 +#, no-c-format +msgid "Enhanced: 2.1.0 improved speed for geography. See Making Geography faster for details." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1962 #, no-c-format msgid "Enhanced: 2.1.0 support for curved geometries was introduced." msgstr "" #. Tag: programlisting -#: reference_measure.xml:1955 +#: reference_measure.xml:1967 #, no-c-format msgid "" "--Find the nearest hospital to each school\n" @@ -2304,55 +2358,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:1961 +#: reference_measure.xml:1973 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:1967 +#: reference_measure.xml:1979 #, no-c-format msgid "ST_Equals" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1969 +#: reference_measure.xml:1981 #, no-c-format msgid "Returns true if the given geometries represent the same geometry. Directionality is ignored." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:1975 +#: reference_measure.xml:1987 #, no-c-format msgid "boolean ST_Equals geometry A geometry B" msgstr "" #. Tag: para -#: reference_measure.xml:1986 +#: reference_measure.xml:1998 #, 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:1995 +#: reference_measure.xml:2007 #, no-c-format msgid "This function will return false if either geometry is invalid even if they are binary equal." msgstr "" #. Tag: para -#: reference_measure.xml:1998 +#: reference_measure.xml:2010 #, no-c-format msgid "&sfs_compliant; s2.1.1.2" msgstr "" #. Tag: para -#: reference_measure.xml:1999 +#: reference_measure.xml:2011 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.24" msgstr "" #. Tag: programlisting -#: reference_measure.xml:2005 +#: reference_measure.xml:2017 #, no-c-format msgid "" "SELECT ST_Equals(ST_GeomFromText('LINESTRING(0 0, 10 10)'),\n" @@ -2371,43 +2425,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2011 +#: reference_measure.xml:2023 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_measure.xml:2018 +#: reference_measure.xml:2030 #, no-c-format msgid "ST_HasArc" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2020 +#: reference_measure.xml:2032 #, no-c-format msgid "Returns true if a geometry or geometry collection contains a circular string" msgstr "" #. Tag: funcprototype -#: reference_measure.xml:2025 +#: reference_measure.xml:2037 #, no-c-format msgid "boolean ST_HasArc geometry geomA" msgstr "" #. Tag: para -#: reference_measure.xml:2035 +#: reference_measure.xml:2047 #, no-c-format msgid "Returns true if a geometry or geometry collection contains a circular string" msgstr "" #. Tag: para -#: reference_measure.xml:2037 +#: reference_measure.xml:2049 #, no-c-format msgid "Availability: 1.2.3?" msgstr "" #. Tag: programlisting -#: reference_measure.xml:2046 +#: reference_measure.xml:2058 #, 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" @@ -2417,73 +2471,73 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2053 +#: reference_measure.xml:2065 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:2059 +#: reference_measure.xml:2071 #, no-c-format msgid "ST_Intersects" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2061 +#: reference_measure.xml:2073 #, 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:2067 +#: reference_measure.xml:2079 #, no-c-format msgid " boolean ST_Intersects geometry geomA geometry geomB boolean ST_Intersects geography geogA geography geogB " msgstr "" #. Tag: para -#: reference_measure.xml:2094 +#: reference_measure.xml:2106 #, 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:2101 +#: reference_measure.xml:2113 #, no-c-format msgid "Do not call with a GEOMETRYCOLLECTION as an argument for geometry version. The geography version supports GEOMETRYCOLLECTION since its a thin wrapper around distance implementation." msgstr "" #. Tag: para -#: reference_measure.xml:2105 +#: reference_measure.xml:2117 #, no-c-format msgid "Performed by the GEOS module (for geometry), geography is native" msgstr "" #. Tag: para -#: reference_measure.xml:2106 +#: reference_measure.xml:2118 #, no-c-format msgid "Availability: 1.5 support for geography was introduced." msgstr "" #. Tag: para -#: reference_measure.xml:2113 +#: reference_measure.xml:2125 #, 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:2120 +#: reference_measure.xml:2132 #, 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:2123 +#: reference_measure.xml:2135 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.27" msgstr "" #. Tag: programlisting -#: reference_measure.xml:2128 +#: reference_measure.xml:2140 #, no-c-format msgid "" "SELECT ST_Intersects('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 2 )'::geometry);\n" @@ -2499,7 +2553,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_measure.xml:2132 +#: reference_measure.xml:2144 #, no-c-format msgid "" "SELECT ST_Intersects(\n" @@ -2513,79 +2567,85 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2136 +#: reference_measure.xml:2148 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:2141 +#: reference_measure.xml:2153 #, no-c-format msgid "ST_Length" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2143 +#: reference_measure.xml:2155 #, 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)" +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:2146 +#: reference_measure.xml:2158 #, 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:2161 +#: reference_measure.xml:2173 +#, 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:2176 #, no-c-format -msgid "For geometry: Returns the cartesian 2D length of the geometry if it is a linestring, multilinestring, ST_Curve, ST_MultiCurve. 0 is returned for areal geometries. For areal geometries use ST_Perimeter. Geometry: Measurements are in the units of the spatial reference system of the geometry. Geography: Units are in meters and also acts as a Perimeter function for areal geogs." +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:2165 +#: reference_measure.xml:2180 #, 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:2166 +#: reference_measure.xml:2181 #, 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:2168 +#: reference_measure.xml:2183 #, 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:2169 reference_measure.xml:2674 +#: reference_measure.xml:2184 reference_measure.xml:2647 #, no-c-format msgid "&sfs_compliant; s2.1.5.1" msgstr "" #. Tag: para -#: reference_measure.xml:2170 +#: reference_measure.xml:2185 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 7.1.2, 9.3.4" msgstr "" #. Tag: para -#: reference_measure.xml:2171 +#: reference_measure.xml:2186 #, no-c-format msgid "Availability: 1.5.0 geography support was introduced in 1.5." msgstr "" #. Tag: para -#: reference_measure.xml:2177 +#: reference_measure.xml:2192 #, no-c-format -msgid "Return length in feet for line string. Note this is in feet because 2249 is Mass State Plane Feet" +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:2179 +#: reference_measure.xml:2194 #, no-c-format msgid "" "SELECT ST_Length(ST_GeomFromText('LINESTRING(743238 2967416,743238 2967450,743265 2967450,\n" @@ -2595,7 +2655,7 @@ msgid "" " 122.630744000095\n" "\n" "\n" - "--Transforming WGS 84 linestring to Massachusetts state plane meters\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" @@ -2608,13 +2668,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2183 +#: reference_measure.xml:2198 #, no-c-format msgid "Return length of WGS 84 geography line" msgstr "" #. Tag: programlisting -#: reference_measure.xml:2184 +#: reference_measure.xml:2199 #, no-c-format msgid "" "-- default calculation is using a sphere rather than spheroid\n" @@ -2624,84 +2684,83 @@ msgid "" " As foo;\n" " length_spheroid | length_sphere\n" "------------------+------------------\n" - " 34310.5703627305 | 34346.2060960742\n" - "(1 row)" + " 34310.5703627288 | 34346.2060960742" msgstr "" #. Tag: para -#: reference_measure.xml:2188 +#: reference_measure.xml:2203 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_measure.xml:2194 +#: reference_measure.xml:2209 #, no-c-format msgid "ST_Length2D" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2196 +#: reference_measure.xml:2211 #, 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:2202 +#: reference_measure.xml:2217 #, no-c-format msgid "float ST_Length2D geometry a_2dlinestring" msgstr "" #. Tag: para -#: reference_measure.xml:2212 +#: reference_measure.xml:2227 #, 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:2221 +#: reference_measure.xml:2236 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:2227 +#: reference_measure.xml:2242 #, no-c-format msgid "ST_3DLength" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2229 +#: reference_measure.xml:2244 #, 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:2235 +#: reference_measure.xml:2250 #, no-c-format msgid "float ST_3DLength geometry a_3dlinestring" msgstr "" #. Tag: para -#: reference_measure.xml:2245 +#: reference_measure.xml:2260 #, 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:2248 +#: reference_measure.xml:2263 #, no-c-format msgid "Changed: 2.0.0 In prior versions this used to be called ST_Length3D" msgstr "" #. Tag: para -#: reference_measure.xml:2255 +#: reference_measure.xml:2270 #, no-c-format -msgid "Return length in feet for a 3D cable. Note this is in feet because 2249 is Mass State Plane Feet" +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:2257 +#: reference_measure.xml:2272 #, no-c-format msgid "" "SELECT ST_3DLength(ST_GeomFromText('LINESTRING(743238 2967416 1,743238 2967450 1,743265 2967450 3,\n" @@ -2712,37 +2771,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2264 +#: reference_measure.xml:2279 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:2270 +#: reference_measure.xml:2285 #, no-c-format -msgid "ST_Length_Spheroid" +msgid "ST_LengthSpheroid" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2272 +#: reference_measure.xml:2287 #, no-c-format msgid "Calculates the 2D or 3D length of a linestring/multilinestring on an ellipsoid. This is useful if the coordinates of the geometry are in longitude/latitude and a length is desired without reprojection." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:2279 +#: reference_measure.xml:2294 #, no-c-format -msgid "float ST_Length_Spheroid geometry a_linestring spheroid a_spheroid" +msgid "float ST_LengthSpheroid geometry a_linestring spheroid a_spheroid" msgstr "" #. Tag: para -#: reference_measure.xml:2290 +#: reference_measure.xml:2305 #, no-c-format msgid "Calculates the length of a geometry on an ellipsoid. This is useful if the coordinates of the geometry are in longitude/latitude and a length is desired without reprojection. The ellipsoid is a separate database type and can be constructed as follows:" msgstr "" #. Tag: literallayout -#: reference_measure.xml:2296 reference_measure.xml:2348 +#: reference_measure.xml:2311 reference_measure.xml:2365 #, no-c-format msgid "" "SPHEROID[<NAME>,<SEMI-MAJOR\n" @@ -2750,28 +2809,40 @@ msgid "" msgstr "" #. Tag: literallayout -#: reference_measure.xml:2299 reference_measure.xml:2351 +#: reference_measure.xml:2314 reference_measure.xml:2368 #, no-c-format msgid "SPHEROID[\"GRS_1980\",6378137,298.257222101]" msgstr "" #. Tag: para -#: reference_measure.xml:2300 reference_measure.xml:2352 +#: reference_measure.xml:2315 reference_measure.xml:2369 #, no-c-format msgid "Will return 0 for anything that is not a MULTILINESTRING or LINESTRING" msgstr "" +#. Tag: para +#: reference_measure.xml:2317 +#, no-c-format +msgid "Availability: 1.2.2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2318 +#, 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:2309 +#: reference_measure.xml:2326 #, no-c-format msgid "" - "SELECT ST_Length_Spheroid( geometry_column,\n" + "SELECT ST_LengthSpheroid( geometry_column,\n" " 'SPHEROID[\"GRS_1980\",6378137,298.257222101]' )\n" " FROM geometry_table;\n" "\n" - "SELECT ST_Length_Spheroid( the_geom, sph_m ) As tot_len,\n" - "ST_Length_Spheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,\n" - "ST_Length_Spheroid(ST_GeometryN(the_geom,2), sph_m) As len_line2\n" + "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" @@ -2780,9 +2851,9 @@ msgid "" " 85204.5207562955 | 13986.8725229309 | 71217.6482333646\n" "\n" " --3D\n" - "SELECT ST_Length_Spheroid( the_geom, sph_m ) As tot_len,\n" - "ST_Length_Spheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,\n" - "ST_Length_Spheroid(ST_GeometryN(the_geom,2), sph_m) As len_line2\n" + "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" @@ -2793,43 +2864,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2316 +#: reference_measure.xml:2333 #, no-c-format -msgid ", , " +msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:2322 +#: reference_measure.xml:2339 #, no-c-format msgid "ST_Length2D_Spheroid" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2324 +#: reference_measure.xml:2341 #, no-c-format msgid "Calculates the 2D length of a linestring/multilinestring on an ellipsoid. This is useful if the coordinates of the geometry are in longitude/latitude and a length is desired without reprojection." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:2331 +#: reference_measure.xml:2348 #, no-c-format msgid "float ST_Length2D_Spheroid geometry a_linestring spheroid a_spheroid" msgstr "" #. Tag: para -#: reference_measure.xml:2342 +#: reference_measure.xml:2359 #, no-c-format msgid "Calculates the 2D length of a geometry on an ellipsoid. This is useful if the coordinates of the geometry are in longitude/latitude and a length is desired without reprojection. The ellipsoid is a separate database type and can be constructed as follows:" msgstr "" #. Tag: para -#: reference_measure.xml:2353 +#: reference_measure.xml:2370 #, no-c-format -msgid "This is much like and except it will throw away the Z coordinate in calculations." +msgid "This is much like except it will throw away the Z coordinate in calculations." msgstr "" #. Tag: programlisting -#: reference_measure.xml:2361 +#: reference_measure.xml:2378 #, no-c-format msgid "" "SELECT ST_Length2D_Spheroid( geometry_column,\n" @@ -2860,97 +2931,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2368 -#, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2374 -#, no-c-format -msgid "ST_3DLength_Spheroid" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2376 -#, no-c-format -msgid "Calculates the length of a geometry on an ellipsoid, taking the elevation into account. This is just an alias for ST_Length_Spheroid." -msgstr "" - -#. Tag: funcprototype -#: reference_measure.xml:2382 -#, no-c-format -msgid "float ST_3DLength_Spheroid geometry a_linestring spheroid a_spheroid" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2393 -#, no-c-format -msgid "Calculates the length of a geometry on an ellipsoid, taking the elevation into account. This is just an alias for ST_Length_Spheroid." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2397 -#, no-c-format -msgid "Changed: 2.0.0 In prior versions this used to return 0 for anything that is not a MULTILINESTRING or LINESTRING and in 2.0.0 on returns the perimeter of if given a polgon." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2398 -#, no-c-format -msgid "This function is just an alias for ST_Length_Spheroid." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2400 -#, no-c-format -msgid "Changed: 2.0.0 In prior versions this used to be called ST_Length3d_Spheroid" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2407 -#, no-c-format -msgid "See ST_Length_Spheroid" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2414 +#: reference_measure.xml:2385 #, no-c-format -msgid ", , " +msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:2420 +#: reference_measure.xml:2391 #, no-c-format msgid "ST_LongestLine" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2422 +#: reference_measure.xml:2393 #, 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:2430 +#: reference_measure.xml:2401 #, no-c-format msgid "geometry ST_LongestLine geometry g1 geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:2445 +#: reference_measure.xml:2416 #, no-c-format msgid "Returns the 2-dimensional longest line between the points of two geometries." msgstr "" #. Tag: para -#: reference_measure.xml:2463 +#: reference_measure.xml:2434 #, no-c-format msgid "Longest line between point and line" msgstr "" #. Tag: programlisting -#: reference_measure.xml:2466 +#: reference_measure.xml:2437 #, no-c-format msgid "" "SELECT ST_AsText(\n" @@ -2965,13 +2982,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2474 +#: reference_measure.xml:2445 #, no-c-format msgid "longest line between polygon and polygon" msgstr "" #. Tag: programlisting -#: reference_measure.xml:2477 +#: reference_measure.xml:2448 #, no-c-format msgid "" "SELECT ST_AsText(\n" @@ -2988,13 +3005,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2493 +#: reference_measure.xml:2464 #, 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:2497 +#: reference_measure.xml:2468 #, no-c-format msgid "" "SELECT ST_AsText(ST_LongestLine(c.the_geom, c.the_geom)) As llinewkt, \n" @@ -3012,49 +3029,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2508 +#: reference_measure.xml:2479 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_measure.xml:2514 +#: reference_measure.xml:2485 #, no-c-format msgid "ST_OrderingEquals" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2516 +#: reference_measure.xml:2487 #, 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:2522 +#: reference_measure.xml:2493 #, no-c-format msgid "boolean ST_OrderingEquals geometry A geometry B" msgstr "" #. Tag: para -#: reference_measure.xml:2533 +#: reference_measure.xml:2504 #, 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:2538 +#: reference_measure.xml:2509 #, 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:2542 +#: reference_measure.xml:2513 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.43" msgstr "" #. Tag: programlisting -#: reference_measure.xml:2548 +#: reference_measure.xml:2519 #, no-c-format msgid "" "SELECT ST_OrderingEquals(ST_GeomFromText('LINESTRING(0 0, 10 10)'),\n" @@ -3080,67 +3097,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2552 +#: reference_measure.xml:2523 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:2558 +#: reference_measure.xml:2529 #, no-c-format msgid "ST_Overlaps" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2560 +#: reference_measure.xml:2531 #, 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:2565 +#: reference_measure.xml:2536 #, no-c-format msgid "boolean ST_Overlaps geometry A geometry B" msgstr "" #. Tag: para -#: reference_measure.xml:2576 +#: reference_measure.xml:2547 #, 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:2581 reference_measure.xml:2914 reference_measure.xml:2928 +#: reference_measure.xml:2552 reference_measure.xml:2880 reference_measure.xml:2894 #, no-c-format msgid "Do not call with a GeometryCollection as an argument" msgstr "" #. Tag: para -#: reference_measure.xml:2583 +#: reference_measure.xml:2554 #, 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:2591 reference_measure.xml:2934 reference_measure.xml:3139 +#: reference_measure.xml:2562 reference_measure.xml:2900 reference_measure.xml:3105 #, no-c-format msgid "&sfs_compliant; s2.1.1.2 // s2.1.13.3" msgstr "" #. Tag: para -#: reference_measure.xml:2592 +#: reference_measure.xml:2563 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.32" msgstr "" #. Tag: para -#: reference_measure.xml:2608 +#: reference_measure.xml:2579 #, no-c-format msgid "MULTIPOINT / MULTIPOINT" msgstr "" #. Tag: programlisting -#: reference_measure.xml:2632 +#: reference_measure.xml:2603 #, 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" @@ -3186,67 +3203,73 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2640 +#: reference_measure.xml:2611 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_measure.xml:2645 +#: reference_measure.xml:2616 #, no-c-format msgid "ST_Perimeter" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2647 +#: reference_measure.xml:2618 #, 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." +msgid "Return the length measurement of the boundary of an ST_Surface or ST_MultiSurface geometry or geography. (Polygon, MultiPolygon). geometry measurement is in units of spatial reference and geography is in meters." msgstr "" #. Tag: funcsynopsis -#: reference_measure.xml:2651 +#: reference_measure.xml:2622 #, no-c-format msgid " float ST_Perimeter geometry g1 float ST_Perimeter geography geog boolean use_spheroid=true " msgstr "" #. Tag: para -#: reference_measure.xml:2667 +#: reference_measure.xml:2638 #, no-c-format -msgid "Returns the 2D perimeter of the geometry/geography if it is a ST_Surface, ST_MultiSurface (Polygon, Multipolygon). 0 is returned for non-areal geometries. For linestrings use ST_Length. Measurements for geometry are in the units of the spatial reference system of the geometry. Measurements for geography are in meters. If use_spheroid is set to false, then will model earth as a sphere instead of a spheroid." +msgid "Returns the 2D perimeter of the geometry/geography if it is a ST_Surface, ST_MultiSurface (Polygon, MultiPolygon). 0 is returned for non-areal geometries. For linear geometries use . For geometry types, units for perimeter measures are specified by the spatial reference system of the geometry." msgstr "" #. Tag: para -#: reference_measure.xml:2672 +#: reference_measure.xml:2641 +#, no-c-format +msgid "For geography types, the calculations are performed using the inverse geodesic problem, where perimeter 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:2645 #, no-c-format msgid "Currently this is an alias for ST_Perimeter2D, but this may change to support higher dimensions." msgstr "" #. Tag: para -#: reference_measure.xml:2675 +#: reference_measure.xml:2648 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 8.1.3, 9.5.4" msgstr "" #. Tag: para -#: reference_measure.xml:2676 +#: reference_measure.xml:2649 #, no-c-format msgid "Availability 2.0.0: Support for geography was introduced" msgstr "" #. Tag: title -#: reference_measure.xml:2680 +#: reference_measure.xml:2653 #, no-c-format msgid "Examples: Geometry" msgstr "" #. Tag: para -#: reference_measure.xml:2681 +#: reference_measure.xml:2654 #, no-c-format -msgid "Return perimeter in feet for polygon and multipolygon. Note this is in feet because 2249 is Mass State Plane Feet" +msgid "Return perimeter in feet for Polygon and MultiPolygon. Note this is in feet because EPSG:2249 is Massachusetts State Plane Feet" msgstr "" #. Tag: programlisting -#: reference_measure.xml:2683 +#: reference_measure.xml:2656 #, no-c-format msgid "" "SELECT ST_Perimeter(ST_GeomFromText('POLYGON((743238 2967416,743238 2967450,743265 2967450,\n" @@ -3274,19 +3297,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_measure.xml:2686 +#: reference_measure.xml:2659 #, no-c-format msgid "Examples: Geography" msgstr "" #. Tag: para -#: reference_measure.xml:2687 +#: reference_measure.xml:2660 #, no-c-format -msgid "Return perimeter in meters and feet for polygon and multipolygon. Note this is geography (WGS 84 long lat)" +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:2688 +#: reference_measure.xml:2661 #, no-c-format msgid "" "SELECT ST_Perimeter(geog) As per_meters, ST_Perimeter(geog)/0.3048 As per_ft \n" @@ -3298,7 +3321,7 @@ msgid "" "37.3790462565251 | 122.634666195949\n" "\n" "\n" - "-- Multipolygon example --\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" @@ -3315,79 +3338,79 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2692 +#: reference_measure.xml:2665 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_measure.xml:2698 +#: reference_measure.xml:2671 #, no-c-format msgid "ST_Perimeter2D" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2700 +#: reference_measure.xml:2673 #, 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:2706 +#: reference_measure.xml:2679 #, no-c-format msgid "float ST_Perimeter2D geometry geomA" msgstr "" #. Tag: para -#: reference_measure.xml:2716 +#: reference_measure.xml:2689 #, 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:2721 +#: reference_measure.xml:2694 #, 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:2735 +#: reference_measure.xml:2708 #, no-c-format msgid "ST_3DPerimeter" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2737 +#: reference_measure.xml:2710 #, 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:2743 +#: reference_measure.xml:2716 #, no-c-format msgid "float ST_3DPerimeter geometry geomA" msgstr "" #. Tag: para -#: reference_measure.xml:2753 +#: reference_measure.xml:2726 #, 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:2756 +#: reference_measure.xml:2729 #, no-c-format msgid "Changed: 2.0.0 In prior versions this used to be called ST_Perimeter3D" msgstr "" #. Tag: para -#: reference_measure.xml:2762 +#: reference_measure.xml:2735 #, no-c-format msgid "Perimeter of a slightly elevated polygon in the air in Massachusetts state plane feet" msgstr "" #. Tag: programlisting -#: reference_measure.xml:2763 +#: reference_measure.xml:2736 #, no-c-format msgid "" "SELECT ST_3DPerimeter(the_geom), ST_Perimeter2d(the_geom), ST_Perimeter(the_geom) FROM\n" @@ -3400,49 +3423,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2770 +#: reference_measure.xml:2743 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_measure.xml:2776 +#: reference_measure.xml:2749 #, no-c-format msgid "ST_PointOnSurface" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2778 +#: reference_measure.xml:2751 #, no-c-format msgid "Returns a POINT guaranteed to lie on the surface." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:2783 +#: reference_measure.xml:2756 #, no-c-format msgid "geometry ST_PointOnSurface geometry g1" msgstr "" #. Tag: para -#: reference_measure.xml:2795 +#: reference_measure.xml:2768 #, no-c-format msgid "Returns a POINT guaranteed to intersect a surface." msgstr "" #. Tag: para -#: reference_measure.xml:2797 +#: reference_measure.xml:2770 #, no-c-format msgid "&sfs_compliant; s3.2.14.2 // s3.2.18.2" msgstr "" #. Tag: para -#: reference_measure.xml:2798 +#: reference_measure.xml:2771 #, 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:2807 +#: reference_measure.xml:2780 #, no-c-format msgid "" "SELECT ST_AsText(ST_PointOnSurface('POINT(0 5)'::geometry));\n" @@ -3471,167 +3494,145 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2813 +#: reference_measure.xml:2786 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:2819 +#: reference_measure.xml:2792 #, no-c-format msgid "ST_Project" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2821 +#: reference_measure.xml:2794 #, 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:2826 +#: reference_measure.xml:2799 #, no-c-format msgid "geography ST_Project geography g1 float distance float azimuth" msgstr "" #. Tag: para -#: reference_measure.xml:2842 +#: reference_measure.xml:2815 #, no-c-format -msgid "Returns a POINT projected from a start point using an azimuth (bearing) measured in radians and distance measured in meters." +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:2843 +#: reference_measure.xml:2816 #, no-c-format -msgid "Distance, azimuth and projection are all aspects of the same operation, describing (or in the case of projection, constructing) the relationship between two points on the world." +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)." msgstr "" #. Tag: para -#: reference_measure.xml:2844 -#, 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 (pi/2), south is azimuth 180 (pi), west is azimuth 270 (pi*1.5)." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2845 +#: reference_measure.xml:2817 #, no-c-format msgid "The distance is given in meters." msgstr "" #. Tag: title -#: reference_measure.xml:2852 +#: reference_measure.xml:2824 #, no-c-format msgid "Example: Using degrees - projected point 100,000 meters and bearing 45 degrees" msgstr "" #. Tag: programlisting -#: reference_measure.xml:2854 +#: reference_measure.xml:2826 #, no-c-format msgid "" "SELECT ST_AsText(ST_Project('POINT(0 0)'::geography, 100000, radians(45.0)));\n" - " st_astext\n" - "------------------------------------------\n" - " POINT(0.63523102912532 0.63947233472882)\n" - "(1 row)" -msgstr "" - -#. Tag: title -#: reference_measure.xml:2858 -#, no-c-format -msgid "Example: Using radians - projected point 100,000 meters and bearing pi/4 (45 degrees)" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2860 -#, no-c-format -msgid "" - "SELECT ST_AsText(ST_Project('POINT(0 0)'::geography, 100000, pi()/4));\n" - " st_astext\n" - "------------------------------------------\n" - " POINT(0.63523102912532 0.63947233472882)\n" + "\n" + " st_astext\n" + "--------------------------------------------\n" + " POINT(0.635231029125537 0.639472334729198)\n" "(1 row)" msgstr "" #. Tag: para -#: reference_measure.xml:2866 +#: reference_measure.xml:2832 #, no-c-format msgid ", , PostgreSQL Math Functions" msgstr "" #. Tag: refname -#: reference_measure.xml:2872 +#: reference_measure.xml:2838 #, no-c-format msgid "ST_Relate" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2874 +#: reference_measure.xml:2840 #, no-c-format msgid "Returns true if this Geometry is spatially related to anotherGeometry, by testing for intersections between the Interior, Boundary and Exterior of the two geometries as specified by the values in the intersectionMatrixPattern. If no intersectionMatrixPattern is passed in, then returns the maximum intersectionMatrixPattern that relates the 2 geometries." msgstr "" #. Tag: funcsynopsis -#: reference_measure.xml:2882 +#: reference_measure.xml:2848 #, 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 int BoundaryNodeRule " +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_measure.xml:2908 +#: reference_measure.xml:2874 #, 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_measure.xml:2913 +#: reference_measure.xml:2879 #, no-c-format msgid "This is especially useful for testing compound checks of intersection, crosses, etc in one step." msgstr "" #. Tag: para -#: reference_measure.xml:2916 +#: reference_measure.xml:2882 #, no-c-format msgid "This is the \"allowable\" version that returns a boolean, not an integer. This is defined in OGC spec" msgstr "" #. Tag: para -#: reference_measure.xml:2919 +#: reference_measure.xml:2885 #, no-c-format msgid "This DOES NOT automagically include an index call. The reason for that is some relationships are anti e.g. Disjoint. If you are using a relationship pattern that requires intersection, then include the && index call." msgstr "" #. Tag: para -#: reference_measure.xml:2924 +#: reference_measure.xml:2890 #, no-c-format msgid "Version 2: Takes geomA and geomB and returns the " msgstr "" #. Tag: para -#: reference_measure.xml:2926 +#: reference_measure.xml:2892 #, no-c-format -msgid "Version 3: same as version 2 bu allows to specify a boundary node rule (1:OGC/MOD2, 2:Endpoint, 3:MultivalentEndpoint, 4:MonovalentEndpoint)" +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:2930 +#: reference_measure.xml:2896 #, no-c-format msgid "not in OGC spec, but implied. see s2.1.13.2" msgstr "" #. Tag: para -#: reference_measure.xml:2935 +#: reference_measure.xml:2901 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.25" msgstr "" #. Tag: para -#: reference_measure.xml:2936 +#: reference_measure.xml:2902 #, no-c-format msgid "Enhanced: 2.0.0 - added support for specifying boundary node rule (requires GEOS >= 3.0)." msgstr "" #. Tag: programlisting -#: reference_measure.xml:2943 +#: reference_measure.xml:2909 #, no-c-format msgid "" "--Find all compounds that intersect and not touch a poly (interior intersects)\n" @@ -3664,43 +3665,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2950 +#: reference_measure.xml:2916 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_measure.xml:2956 +#: reference_measure.xml:2922 #, no-c-format msgid "ST_RelateMatch" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2958 +#: reference_measure.xml:2924 #, no-c-format msgid "Returns true if intersectionMattrixPattern1 implies intersectionMatrixPattern2" msgstr "" #. Tag: funcprototype -#: reference_measure.xml:2963 +#: reference_measure.xml:2929 #, no-c-format msgid "boolean ST_RelateMatch text intersectionMatrix text intersectionMatrixPattern" msgstr "" #. Tag: para -#: reference_measure.xml:2974 +#: reference_measure.xml:2940 #, no-c-format msgid "Takes intersectionMatrix and intersectionMatrixPattern and Returns true if the intersectionMatrix satisfies the intersectionMatrixPattern. For more information refer to ." msgstr "" #. Tag: para -#: reference_measure.xml:2977 +#: reference_measure.xml:2943 #, no-c-format msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0." msgstr "" #. Tag: programlisting -#: reference_measure.xml:2983 +#: reference_measure.xml:2949 #, no-c-format msgid "" "SELECT ST_RelateMatch('101202FFF', 'TTTTTTFFF') ;\n" @@ -3722,43 +3723,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:2989 +#: reference_measure.xml:2955 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:2995 +#: reference_measure.xml:2961 #, no-c-format msgid "ST_ShortestLine" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:2997 +#: reference_measure.xml:2963 #, no-c-format msgid "Returns the 2-dimensional shortest line between two geometries" msgstr "" #. Tag: funcprototype -#: reference_measure.xml:3002 +#: reference_measure.xml:2968 #, no-c-format msgid "geometry ST_ShortestLine geometry g1 geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:3017 +#: reference_measure.xml:2983 #, no-c-format -msgid "Returns the 2-dimensional shortest line between two geometries. The function will only return the first shortest line if more than one, that the function finds. If g1 and g2 intersects in just one point the function will return a line with both start and end in that intersection-point. If g1 and g2 are intersecting with more than one point the function will return a line with start and end in the same point but it can be any of the intersecting points. The line returned will always start in g1 and end in g2. The length of the line this function returns will always be the same as st_distance returns for g1 and g2." +msgid "Returns the 2-dimensional shortest line between two geometries. The function will only return the first shortest line if more than one, that the function finds. If g1 and g2 intersects in just one point the function will return a line with both start and end in that intersection-point. If g1 and g2 are intersecting with more than one point the function will return a line with start and end in the same point but it can be any of the intersecting points. The line returned will always start in g1 and end in g2. The length of the line this function returns will always be the same as ST_Distance returns for g1 and g2." msgstr "" #. Tag: para -#: reference_measure.xml:3041 +#: reference_measure.xml:3007 #, no-c-format msgid "Shortest line between point and linestring" msgstr "" #. Tag: programlisting -#: reference_measure.xml:3044 +#: reference_measure.xml:3010 #, no-c-format msgid "" "SELECT ST_AsText(\n" @@ -3773,13 +3774,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:3052 +#: reference_measure.xml:3018 #, no-c-format msgid "shortest line between polygon and polygon" msgstr "" #. Tag: programlisting -#: reference_measure.xml:3055 +#: reference_measure.xml:3021 #, no-c-format msgid "" "SELECT ST_AsText(\n" @@ -3793,85 +3794,85 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:3067 +#: reference_measure.xml:3033 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_measure.xml:3073 +#: reference_measure.xml:3039 #, no-c-format msgid "ST_Touches" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:3075 +#: reference_measure.xml:3041 #, 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_measure.xml:3081 +#: reference_measure.xml:3047 #, no-c-format msgid "boolean ST_Touches geometry g1 geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:3096 +#: reference_measure.xml:3062 #, 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:3103 +#: reference_measure.xml:3069 #, no-c-format msgid "In mathematical terms, this predicate is expressed as:" msgstr "" #. Tag: para -#: reference_measure.xml:3113 +#: reference_measure.xml:3079 #, no-c-format msgid "The allowable DE-9IM Intersection Matrices for the two geometries are:" msgstr "" #. Tag: markup -#: reference_measure.xml:3117 +#: reference_measure.xml:3083 #, no-c-format msgid "FT*******" msgstr "" #. Tag: markup -#: reference_measure.xml:3121 +#: reference_measure.xml:3087 #, no-c-format msgid "F**T*****" msgstr "" #. Tag: markup -#: reference_measure.xml:3125 +#: reference_measure.xml:3091 #, no-c-format msgid "F***T****" msgstr "" #. Tag: para -#: reference_measure.xml:3134 +#: reference_measure.xml:3100 #, 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:3140 +#: reference_measure.xml:3106 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.28" msgstr "" #. Tag: para -#: reference_measure.xml:3146 +#: reference_measure.xml:3112 #, no-c-format msgid "The ST_Touches predicate returns TRUE in all the following illustrations." msgstr "" #. Tag: programlisting -#: reference_measure.xml:3216 +#: reference_measure.xml:3182 #, no-c-format msgid "" "SELECT ST_Touches('LINESTRING(0 0, 1 1, 0 2)'::geometry, 'POINT(1 1)'::geometry);\n" @@ -3888,49 +3889,49 @@ msgid "" msgstr "" #. Tag: refname -#: reference_measure.xml:3222 +#: reference_measure.xml:3188 #, no-c-format msgid "ST_Within" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:3224 +#: reference_measure.xml:3190 #, no-c-format msgid "Returns true if the geometry A is completely inside geometry B" msgstr "" #. Tag: funcprototype -#: reference_measure.xml:3229 +#: reference_measure.xml:3195 #, no-c-format msgid "boolean ST_Within geometry A geometry B" msgstr "" #. Tag: para -#: reference_measure.xml:3244 +#: reference_measure.xml:3210 #, no-c-format msgid "Returns TRUE if geometry A is completely inside geometry B. For this function to make sense, the source geometries must both be of the same coordinate projection, having the same SRID. It is a given that if ST_Within(A,B) is true and ST_Within(B,A) is true, then the two geometries are considered spatially equal." msgstr "" #. Tag: para -#: reference_measure.xml:3259 +#: reference_measure.xml:3225 #, 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:3267 +#: reference_measure.xml:3233 #, no-c-format msgid "&sfs_compliant; s2.1.1.2 // s2.1.13.3 - a.Relate(b, 'T*F**F***')" msgstr "" #. Tag: para -#: reference_measure.xml:3270 +#: reference_measure.xml:3236 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.30" msgstr "" #. Tag: programlisting -#: reference_measure.xml:3275 +#: reference_measure.xml:3241 #, no-c-format msgid "" "--a circle within a circle\n" @@ -3952,7 +3953,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:3286 +#: reference_measure.xml:3252 #, no-c-format msgid ", , " msgstr "" diff --git a/doc/po/templates/reference_misc.xml.pot b/doc/po/templates/reference_misc.xml.pot index 4a8699176..e5ac44eff 100644 --- a/doc/po/templates/reference_misc.xml.pot +++ b/doc/po/templates/reference_misc.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -81,7 +81,7 @@ msgid "&T_support;" msgstr "" #. Tag: title -#: reference_misc.xml:34 reference_misc.xml:76 reference_misc.xml:118 reference_misc.xml:188 reference_misc.xml:258 reference_misc.xml:312 reference_misc.xml:360 reference_misc.xml:404 reference_misc.xml:453 reference_misc.xml:497 +#: reference_misc.xml:34 reference_misc.xml:76 reference_misc.xml:118 reference_misc.xml:188 reference_misc.xml:258 reference_misc.xml:312 reference_misc.xml:360 reference_misc.xml:404 reference_misc.xml:453 reference_misc.xml:500 #, no-c-format msgid "Examples" msgstr "" @@ -111,7 +111,7 @@ msgid "" msgstr "" #. Tag: title -#: reference_misc.xml:41 reference_misc.xml:83 reference_misc.xml:125 reference_misc.xml:195 reference_misc.xml:264 reference_misc.xml:318 reference_misc.xml:365 reference_misc.xml:411 reference_misc.xml:460 reference_misc.xml:504 +#: reference_misc.xml:41 reference_misc.xml:83 reference_misc.xml:125 reference_misc.xml:195 reference_misc.xml:264 reference_misc.xml:318 reference_misc.xml:365 reference_misc.xml:411 reference_misc.xml:460 reference_misc.xml:507 #, no-c-format msgid "See Also" msgstr "" @@ -648,7 +648,7 @@ msgstr "" #. Tag: refname #: reference_misc.xml:468 #, no-c-format -msgid "ST_Point_Inside_Circle" +msgid "ST_PointInsideCircle" msgstr "" #. Tag: refpurpose @@ -660,13 +660,13 @@ msgstr "" #. Tag: funcprototype #: reference_misc.xml:475 #, no-c-format -msgid "boolean ST_Point_Inside_Circle geometry a_point float center_x float center_y float radius" +msgid "boolean ST_PointInsideCircle geometry a_point float center_x float center_y float radius" msgstr "" #. Tag: para #: reference_misc.xml:488 #, no-c-format -msgid "The syntax for this functions is point_inside_circle(<geometry>,<circle_center_x>,<circle_center_y>,<radius>). Returns the true if the geometry is a point and is inside the circle. Returns false otherwise." +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 @@ -675,12 +675,24 @@ msgstr "" msgid "This only works for points as the name suggests" msgstr "" +#. Tag: para +#: reference_misc.xml:494 +#, no-c-format +msgid "Availability: 1.2" +msgstr "" + +#. Tag: para +#: reference_misc.xml:495 +#, 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:499 +#: reference_misc.xml:502 #, no-c-format msgid "" - "SELECT ST_Point_Inside_Circle(ST_Point(1,2), 0.5, 2, 3);\n" - " st_point_inside_circle\n" + "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 b6ed9aced..b9b28f319 100644 --- a/doc/po/templates/reference_operator.xml.pot +++ b/doc/po/templates/reference_operator.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -39,7 +39,7 @@ msgid " boolean &&TRUE if A's 3D bounding box intersects B's 3D bounding box." +msgid "Returns TRUE if A's n-D bounding box intersects B's n-D bounding box." msgstr "" #. Tag: funcprototype @@ -858,47 +858,59 @@ msgstr "" #. Tag: refpurpose #: reference_operator.xml:857 #, no-c-format -msgid "Returns the distance between two points. For point / point checks it uses floating point accuracy (as opposed to the double precision accuracy of the underlying point geometry). For other geometry types the distance between the floating point bounding box centroids is returned. Useful for doing distance ordering and nearest neighbor limits using KNN gist functionality." +msgid "Returns the 2D distance between A and B." msgstr "" -#. Tag: funcprototype -#: reference_operator.xml:864 +#. Tag: funcsynopsis +#: reference_operator.xml:863 #, no-c-format -msgid "double precision <-> geometry A geometry B " +msgid " double precision <-> geometry A geometry B double precision <-> geography A geography B " msgstr "" #. Tag: para -#: reference_operator.xml:885 +#: reference_operator.xml:901 #, no-c-format -msgid "The <-> operator returns distance between two points read from the spatial index for points (float precision). For other geometries it returns the distance from centroid of bounding box of geometries. Useful for doing nearest neighbor approximate distance ordering." +msgid "The <-> operator returns the 2D distance between two geometries. Used in the \"ORDER BY\" clause provides index-assisted nearest-neighbor result sets. For PostgreSQL below 9.5 only gives centroid distance of bounding boxes and for PostgreSQL 9.5+, does true KNN distance search giving true distance between geometries, and distance sphere for geographies." msgstr "" #. Tag: para -#: reference_operator.xml:888 reference_operator.xml:954 +#: reference_operator.xml:910 #, no-c-format -msgid "This operand will make use of any indexes that may be available on the geometries. It is different from other operators that use spatial indexes in that the spatial index is only used when the operator is in the ORDER BY clause." +msgid "This operand will make use of 2D GiST indexes that may be available on the geometries. It is different from other operators that use spatial indexes in that the spatial index is only used when the operator is in the ORDER BY clause." msgstr "" #. Tag: para -#: reference_operator.xml:891 +#: reference_operator.xml:911 reference_operator.xml:1104 #, no-c-format msgid "Index only kicks in if one of the geometries is a constant (not in a subquery/cte). e.g. 'SRID=3005;POINT(1011102 450541)'::geometry instead of a.geom" msgstr "" #. Tag: para -#: reference_operator.xml:892 +#: reference_operator.xml:912 #, no-c-format msgid "Refer to OpenGeo workshop: Nearest-Neighbour Searching for real live example." msgstr "" #. Tag: para -#: reference_operator.xml:894 reference_operator.xml:959 +#: reference_operator.xml:914 +#, no-c-format +msgid "Enhanced: 2.2.0 -- True KNN (\"K nearest neighbor\") behavior for geometry and geography for PostgreSQL 9.5+. Note for geography KNN is based on sphere rather than spheroid. For PostgreSQL 9.4 and below, geography support is new but only supports centroid box." +msgstr "" + +#. Tag: para +#: reference_operator.xml:915 +#, no-c-format +msgid "Changed: 2.2.0 -- For PostgreSQL 9.5 users, old Hybrid syntax may be slower, so you'll want to get rid of that hack if you are running your code only on PostGIS 2.2+ 9.5+. See examples below." +msgstr "" + +#. Tag: para +#: reference_operator.xml:916 #, no-c-format -msgid "Availability: 2.0.0 only available for PostgreSQL 9.1+" +msgid "Availability: 2.0.0 -- Weak KNN provides nearest neighbors based on geometry centroid distances instead of true distances. Exact results for points, inexact for all other types. Available for PostgreSQL 9.1+" msgstr "" #. Tag: programlisting -#: reference_operator.xml:901 +#: reference_operator.xml:923 #, no-c-format msgid "" ", " msgstr "" #. Tag: refname -#: reference_operator.xml:923 +#: reference_operator.xml:945 +#, no-c-format +msgid "|=|" +msgstr "" + +#. Tag: refpurpose +#: reference_operator.xml:947 +#, no-c-format +msgid "Returns the distance between A and B trajectories at their closest point of approach." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:954 +#, no-c-format +msgid "double precision |=| geometry A geometry B " +msgstr "" + +#. Tag: para +#: reference_operator.xml:976 +#, no-c-format +msgid "The |=| operator returns the 3D distance between two trajectories (See ). This is the same as but as an operator it can be used for doing nearest neightbor searches using an N-dimensional index (requires PostgreSQL 9.5.0 or higher)." +msgstr "" + +#. Tag: para +#: reference_operator.xml:984 +#, no-c-format +msgid "This operand will make use of ND GiST indexes that may be available on the geometries. It is different from other operators that use spatial indexes in that the spatial index is only used when the operator is in the ORDER BY clause." +msgstr "" + +#. Tag: para +#: reference_operator.xml:985 +#, no-c-format +msgid "Index only kicks in if one of the geometries is a constant (not in a subquery/cte). e.g. 'SRID=3005;LINESTRINGM(0 0 0,0 0 1)'::geometry instead of a.geom" +msgstr "" + +#. Tag: para +#: reference_operator.xml:987 +#, no-c-format +msgid "Availability: 2.2.0. Index-supported only available for PostgreSQL 9.5+" +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:993 +#, no-c-format +msgid "" + "-- Save a literal query trajectory in a psql variable...\n" + "\\set qt 'ST_AddMeasure(ST_MakeLine(ST_MakePointM(-350,300,0),ST_MakePointM(-410,490,0)),10,20)'\n" + "-- Run the query !\n" + "SELECT track_id, dist FROM (\n" + " SELECT track_id, ST_DistanceCPA(tr,:qt) dist\n" + " FROM trajectories\n" + " ORDER BY tr |=| :qt\n" + " LIMIT 5\n" + ") foo;\n" + " track_id dist\n" + "----------+-------------------\n" + " 395 | 0.576496831518066\n" + " 380 | 5.06797130410151\n" + " 390 | 7.72262293958322\n" + " 385 | 9.8004461358071\n" + " 405 | 10.9534397988433\n" + "(5 rows)" +msgstr "" + +#. Tag: para +#: reference_operator.xml:997 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_operator.xml:1007 #, no-c-format msgid "<#>" msgstr "" #. Tag: refpurpose -#: reference_operator.xml:925 +#: reference_operator.xml:1009 #, no-c-format -msgid "Returns the distance between bounding box of 2 geometries. For point / point checks it's almost the same as distance (though may be different since the bounding box is at floating point accuracy and geometries are double precision). Useful for doing distance ordering and nearest neighbor limits using KNN gist functionality." +msgid "Returns the 2D distance between A and B bounding boxes." msgstr "" #. Tag: funcprototype -#: reference_operator.xml:931 +#: reference_operator.xml:1016 #, no-c-format msgid "double precision <#> geometry A geometry B " msgstr "" #. Tag: para -#: reference_operator.xml:952 +#: reference_operator.xml:1037 #, no-c-format -msgid "The <#> KNN GIST operator returns distance between two floating point bounding boxes read from the spatial index if available. Useful for doing nearest neighbor approximate distance ordering." +msgid "The <#> operator returns distance between two floating point bounding boxes, possibly reading them from a spatial index (PostgreSQL 9.1+ required). Useful for doing nearest neighbor approximate distance ordering." msgstr "" #. Tag: para -#: reference_operator.xml:957 +#: reference_operator.xml:1039 reference_operator.xml:1158 +#, no-c-format +msgid "This operand will make use of any indexes that may be available on the geometries. It is different from other operators that use spatial indexes in that the spatial index is only used when the operator is in the ORDER BY clause." +msgstr "" + +#. Tag: para +#: reference_operator.xml:1042 #, no-c-format msgid "Index only kicks in if one of the geometries is a constant e.g. ORDER BY (ST_GeomFromText('POINT(1 2)') <#> geom) instead of g1.geom <#>." msgstr "" +#. Tag: para +#: reference_operator.xml:1044 +#, no-c-format +msgid "Availability: 2.0.0 -- KNN only available for PostgreSQL 9.1+" +msgstr "" + #. Tag: programlisting -#: reference_operator.xml:965 +#: reference_operator.xml:1050 #, no-c-format msgid "" ", " +msgstr "" + +#. Tag: refname +#: reference_operator.xml:1060 +#, no-c-format +msgid "<<->>" +msgstr "" + +#. Tag: refpurpose +#: reference_operator.xml:1062 +#, no-c-format +msgid "Returns the n-D distance between the centroids of A and B bounding boxes." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:1070 +#, no-c-format +msgid "double precision <<->> geometry A geometry B " +msgstr "" + +#. Tag: para +#: reference_operator.xml:1091 +#, no-c-format +msgid "The <<->> operator returns the n-D (euclidean) distance between the centroids of the bounding boxes of two geometries. Useful for doing nearest neighbor approximate distance ordering." +msgstr "" + +#. Tag: para +#: reference_operator.xml:1098 +#, no-c-format +msgid "This operand will make use of n-D GiST indexes that may be available on the geometries. It is different from other operators that use spatial indexes in that the spatial index is only used when the operator is in the ORDER BY clause." +msgstr "" + +#. Tag: para +#: reference_operator.xml:1110 reference_operator.xml:1167 +#, no-c-format +msgid "Availability: 2.2.0 -- KNN only available for PostgreSQL 9.1+" +msgstr "" + +#. Tag: para +#: reference_operator.xml:1117 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_operator.xml:1126 +#, no-c-format +msgid "<<#>>" +msgstr "" + +#. Tag: refpurpose +#: reference_operator.xml:1128 +#, no-c-format +msgid "Returns the n-D distance between A and B bounding boxes." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:1135 +#, no-c-format +msgid "double precision <<#>> geometry A geometry B " +msgstr "" + +#. Tag: para +#: reference_operator.xml:1156 +#, no-c-format +msgid "The <<#>> operator returns distance between two floating point bounding boxes, possibly reading them from a spatial index (PostgreSQL 9.1+ required). Useful for doing nearest neighbor approximate distance ordering." +msgstr "" + +#. Tag: para +#: reference_operator.xml:1161 +#, no-c-format +msgid "Index only kicks in if one of the geometries is a constant e.g. ORDER BY (ST_GeomFromText('POINT(1 2)') <<#>> geom) instead of g1.geom <<#>>." +msgstr "" + +#. Tag: para +#: reference_operator.xml:1173 #, no-c-format -msgid ", , " +msgid ", " msgstr "" diff --git a/doc/po/templates/reference_output.xml.pot b/doc/po/templates/reference_output.xml.pot index 9213dc166..09f0f2ac6 100644 --- a/doc/po/templates/reference_output.xml.pot +++ b/doc/po/templates/reference_output.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-14 21:54+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -39,7 +39,7 @@ msgid " bytea ST_AsBinary msgstr "" #. Tag: title -#: reference_output.xml:35 reference_output.xml:109 reference_output.xml:162 reference_output.xml:238 reference_output.xml:339 reference_output.xml:440 reference_output.xml:496 reference_output.xml:561 reference_output.xml:604 reference_output.xml:707 reference_output.xml:755 reference_output.xml:813 reference_output.xml:879 reference_output.xml:944 reference_output.xml:988 +#: reference_output.xml:35 reference_output.xml:109 reference_output.xml:162 reference_output.xml:238 reference_output.xml:339 reference_output.xml:440 reference_output.xml:496 reference_output.xml:561 reference_output.xml:604 reference_output.xml:726 reference_output.xml:774 reference_output.xml:828 reference_output.xml:905 reference_output.xml:952 #, no-c-format msgid "Description" msgstr "" @@ -105,7 +105,7 @@ msgid "Changed: 2.0.0 Inputs to this function can not be unknown -- must be geom msgstr "" #. Tag: para -#: reference_output.xml:61 reference_output.xml:771 +#: reference_output.xml:61 reference_output.xml:790 #, no-c-format msgid "&sfs_compliant; s2.1.1.1" msgstr "" @@ -117,31 +117,31 @@ msgid "&sqlmm_compliant; SQL-MM 3: 5.1.37" msgstr "" #. Tag: para -#: reference_output.xml:63 reference_output.xml:123 reference_output.xml:177 reference_output.xml:449 reference_output.xml:721 reference_output.xml:773 +#: reference_output.xml:63 reference_output.xml:123 reference_output.xml:177 reference_output.xml:449 reference_output.xml:740 reference_output.xml:792 #, no-c-format msgid "&curve_support;" msgstr "" #. Tag: para -#: reference_output.xml:64 reference_output.xml:124 reference_output.xml:178 reference_output.xml:390 reference_output.xml:664 +#: reference_output.xml:64 reference_output.xml:124 reference_output.xml:178 reference_output.xml:390 reference_output.xml:683 #, no-c-format msgid "&P_support;" msgstr "" #. Tag: para -#: reference_output.xml:65 reference_output.xml:125 reference_output.xml:179 reference_output.xml:391 reference_output.xml:667 +#: reference_output.xml:65 reference_output.xml:125 reference_output.xml:179 reference_output.xml:391 reference_output.xml:686 #, no-c-format msgid "&T_support;" msgstr "" #. Tag: para -#: reference_output.xml:66 reference_output.xml:122 reference_output.xml:176 reference_output.xml:281 reference_output.xml:389 reference_output.xml:448 reference_output.xml:523 reference_output.xml:662 +#: reference_output.xml:66 reference_output.xml:122 reference_output.xml:176 reference_output.xml:281 reference_output.xml:389 reference_output.xml:448 reference_output.xml:523 reference_output.xml:681 #, no-c-format msgid "&Z_support;" msgstr "" #. Tag: title -#: reference_output.xml:71 reference_output.xml:130 reference_output.xml:184 reference_output.xml:285 reference_output.xml:453 reference_output.xml:527 reference_output.xml:580 reference_output.xml:725 reference_output.xml:778 reference_output.xml:842 reference_output.xml:896 reference_output.xml:961 reference_output.xml:997 +#: reference_output.xml:71 reference_output.xml:130 reference_output.xml:184 reference_output.xml:285 reference_output.xml:453 reference_output.xml:527 reference_output.xml:580 reference_output.xml:744 reference_output.xml:797 reference_output.xml:857 reference_output.xml:919 reference_output.xml:961 #, no-c-format msgid "Examples" msgstr "" @@ -182,7 +182,7 @@ msgid "" msgstr "" #. Tag: title -#: reference_output.xml:79 reference_output.xml:138 reference_output.xml:191 reference_output.xml:409 reference_output.xml:531 reference_output.xml:729 reference_output.xml:785 reference_output.xml:901 reference_output.xml:966 reference_output.xml:1002 +#: reference_output.xml:79 reference_output.xml:138 reference_output.xml:191 reference_output.xml:409 reference_output.xml:531 reference_output.xml:748 reference_output.xml:804 reference_output.xml:928 reference_output.xml:966 #, no-c-format msgid "See Also" msgstr "" @@ -300,7 +300,7 @@ msgid "The WKT spec does not include the SRID. To get the OGC WKT format use ST_ msgstr "" #. Tag: para -#: reference_output.xml:169 reference_output.xml:763 +#: reference_output.xml:169 reference_output.xml:782 #, 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 "" @@ -922,7 +922,7 @@ msgstr "" #. Tag: para #: reference_output.xml:608 #, no-c-format -msgid "There are various options for translating PostGIS geometries to X3D since X3D geometry types don't map directly to PostGIS geometry types and some newer X3D types that might be better mappings we ahve avoided since most rendering tools don't currently support them. These are the mappings we have settled on. Feel free to post a bug ticket if you have thoughts on the idea or ways we can allow people to denote their preferred mappings." +msgid "There are various options for translating PostGIS geometries to X3D since X3D geometry types don't map directly to PostGIS geometry types and some newer X3D types that might be better mappings we have avoided since most rendering tools don't currently support them. These are the mappings we have settled on. Feel free to post a bug ticket if you have thoughts on the idea or ways we can allow people to denote their preferred mappings." msgstr "" #. Tag: para @@ -931,158 +931,188 @@ msgstr "" msgid "Below is how we currently map PostGIS 2D/3D types to X3D types" msgstr "" -#. Tag: entry +#. Tag: para +#: reference_output.xml:613 +#, no-c-format +msgid "The 'options' argument is a bitfield. For PostGIS 2.2+, this is used to denote whether to represent coordinates with X3D GeoCoordinates Geospatial node and also whether to flip the x/y axis. By default, ST_AsX3D outputs in database form (long,lat or X,Y), but X3D default of lat/lon, y/x may be preferred." +msgstr "" + +#. Tag: para #: reference_output.xml:617 #, no-c-format +msgid "0: X/Y in database order (e.g. long/lat = X,Y is standard database order), default value, and non-spatial coordinates (just regular old Coordinate tag)." +msgstr "" + +#. Tag: para +#: reference_output.xml:621 +#, no-c-format +msgid "1: Flip X and Y. If used in conjunction with the GeoCoordinate option switch, then output will be default \"latitude_first\" and coordinates will be flipped as well." +msgstr "" + +#. Tag: para +#: reference_output.xml:625 +#, no-c-format +msgid "2: Output coordinates in GeoSpatial GeoCoordinates. This option will throw an error if geometries are not in WGS 84 long lat (srid: 4326). This is currenlty the only GeoCoordinate type supported. Refer to X3D specs specifying a spatial reference system.. Default output will be GeoCoordinate geoSystem='\"GD\" \"WE\" \"longitude_first\"'. If you prefer the X3D default of GeoCoordinate geoSystem='\"GD\" \"WE\" \"latitude_first\"' use (2 + 1) = 3" +msgstr "" + +#. Tag: entry +#: reference_output.xml:635 +#, no-c-format msgid "PostGIS Type" msgstr "" #. Tag: entry -#: reference_output.xml:618 +#: reference_output.xml:636 #, no-c-format msgid "2D X3D Type" msgstr "" #. Tag: entry -#: reference_output.xml:619 +#: reference_output.xml:637 #, no-c-format msgid "3D X3D Type" msgstr "" #. Tag: entry -#: reference_output.xml:624 +#: reference_output.xml:642 #, no-c-format msgid "LINESTRING" msgstr "" #. Tag: entry -#: reference_output.xml:625 reference_output.xml:630 +#: reference_output.xml:643 reference_output.xml:648 #, no-c-format msgid "not yet implemented - will be PolyLine2D" msgstr "" #. Tag: entry -#: reference_output.xml:626 +#: reference_output.xml:644 #, no-c-format msgid "LineSet" msgstr "" #. Tag: entry -#: reference_output.xml:629 +#: reference_output.xml:647 #, no-c-format msgid "MULTILINESTRING" msgstr "" #. Tag: entry -#: reference_output.xml:631 +#: reference_output.xml:649 #, no-c-format msgid "IndexedLineSet" msgstr "" #. Tag: entry -#: reference_output.xml:634 +#: reference_output.xml:652 #, no-c-format msgid "MULTIPOINT" msgstr "" #. Tag: entry -#: reference_output.xml:635 +#: reference_output.xml:653 #, no-c-format msgid "Polypoint2D" msgstr "" #. Tag: entry -#: reference_output.xml:636 +#: reference_output.xml:654 #, no-c-format msgid "PointSet" msgstr "" #. Tag: entry -#: reference_output.xml:639 +#: reference_output.xml:657 #, no-c-format msgid "POINT" msgstr "" #. Tag: entry -#: reference_output.xml:640 reference_output.xml:641 +#: reference_output.xml:658 reference_output.xml:659 #, no-c-format msgid "outputs the space delimited coordinates" msgstr "" #. Tag: entry -#: reference_output.xml:644 +#: reference_output.xml:662 #, no-c-format msgid "(MULTI) POLYGON, POLYHEDRALSURFACE" msgstr "" #. Tag: entry -#: reference_output.xml:645 +#: reference_output.xml:663 #, no-c-format msgid "Invalid X3D markup" msgstr "" #. Tag: entry -#: reference_output.xml:646 +#: reference_output.xml:664 #, no-c-format msgid "IndexedFaceSet (inner rings currently output as another faceset)" msgstr "" #. Tag: entry -#: reference_output.xml:649 +#: reference_output.xml:667 #, no-c-format msgid "TIN" msgstr "" #. Tag: entry -#: reference_output.xml:650 +#: reference_output.xml:668 #, no-c-format msgid "TriangleSet2D (Not Yet Implemented)" msgstr "" #. Tag: entry -#: reference_output.xml:651 +#: reference_output.xml:669 #, no-c-format msgid "IndexedTriangleSet" msgstr "" #. Tag: para -#: reference_output.xml:656 +#: reference_output.xml:674 #, no-c-format msgid "2D geometry support not yet complete. Inner rings currently just drawn as separate polygons. We are working on these." msgstr "" #. Tag: para -#: reference_output.xml:657 +#: reference_output.xml:675 #, no-c-format msgid "Lots of advancements happening in 3D space particularly with X3D Integration with HTML5" msgstr "" #. Tag: para -#: reference_output.xml:658 +#: reference_output.xml:676 #, no-c-format msgid "There is also a nice open source X3D viewer you can use to view rendered geometries. Free Wrl http://freewrl.sourceforge.net/ binaries available for Mac, Linux, and Windows. Use the FreeWRL_Launcher packaged to view the geometries." msgstr "" #. Tag: para -#: reference_output.xml:659 +#: reference_output.xml:677 #, no-c-format msgid "Also check out PostGIS minimalist X3D viewer that utilizes this function and x3dDom html/js open source toolkit." msgstr "" #. Tag: para -#: reference_output.xml:660 +#: reference_output.xml:678 #, no-c-format msgid "Availability: 2.0.0: ISO-IEC-19776-1.2-X3DEncodings-XML" msgstr "" +#. Tag: para +#: reference_output.xml:679 +#, no-c-format +msgid "Enhanced: 2.2.0: Support for GeoCoordinates and axis (x/y, long/lat) flipping. Look at options for details." +msgstr "" + #. Tag: title -#: reference_output.xml:672 +#: reference_output.xml:691 #, no-c-format msgid "Example: Create a fully functional X3D document - This will generate a cube that is viewable in FreeWrl and other X3D viewers." msgstr "" #. Tag: programlisting -#: reference_output.xml:673 +#: reference_output.xml:692 #, no-c-format msgid "" "\n" @@ -1124,13 +1154,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_output.xml:676 +#: reference_output.xml:695 #, no-c-format msgid "Example: An Octagon elevated 3 Units and decimal precision of 6" msgstr "" #. Tag: programlisting -#: reference_output.xml:677 +#: reference_output.xml:696 #, no-c-format msgid "" "SELECT ST_AsX3D(\n" @@ -1148,13 +1178,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_output.xml:680 +#: reference_output.xml:699 #, no-c-format msgid "Example: TIN" msgstr "" #. Tag: programlisting -#: reference_output.xml:681 +#: reference_output.xml:700 #, no-c-format msgid "" "text ST_GeoHash geometry geom integer maxchars=full_precision_of_point" msgstr "" #. Tag: para -#: reference_output.xml:709 +#: reference_output.xml:728 #, no-c-format msgid "Return a GeoHash representation (http://en.wikipedia.org/wiki/Geohash) of the geometry. A GeoHash encodes a point into a text form that is sortable and searchable based on prefixing. A shorter GeoHash is a less precise representation of a point. It can also be thought of as a box, that contains the actual point." msgstr "" #. Tag: para -#: reference_output.xml:711 +#: reference_output.xml:730 #, no-c-format msgid "If no maxchars is specficified ST_GeoHash returns a GeoHash based on full precision of the input geometry type. Points return a GeoHash with 20 characters of precision (about enough to hold the full double precision of the input). Other types return a GeoHash with a variable amount of precision, based on the size of the feature. Larger features are represented with less precision, smaller features with more precision. The idea is that the box implied by the GeoHash will always contain the input feature." msgstr "" #. Tag: para -#: reference_output.xml:713 +#: reference_output.xml:732 #, no-c-format msgid "If maxchars is specified ST_GeoHash returns a GeoHash with at most that many characters so a possibly lower precision representation of the input geometry. For non-points, the starting point of the calculation is the center of the bounding box of the geometry." msgstr "" #. Tag: para -#: reference_output.xml:715 +#: reference_output.xml:734 #, no-c-format msgid "Availability: 1.4.0" msgstr "" #. Tag: para -#: reference_output.xml:718 +#: reference_output.xml:737 #, no-c-format msgid "ST_GeoHash will not work with geometries that are not in geographic (lon/lat) coordinates." msgstr "" #. Tag: programlisting -#: reference_output.xml:726 +#: reference_output.xml:745 #, no-c-format msgid "" " text ST_AsText geometry g1 text ST_AsText geography g1 " msgstr "" #. Tag: para -#: reference_output.xml:757 +#: reference_output.xml:776 #, no-c-format msgid "Returns the Well-Known Text representation of the geometry/geography." msgstr "" #. Tag: para -#: reference_output.xml:760 +#: reference_output.xml:779 #, 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:767 +#: reference_output.xml:786 #, 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:770 +#: reference_output.xml:789 #, no-c-format msgid "Availability: 1.5 - support for geography was introduced." msgstr "" #. Tag: para -#: reference_output.xml:772 +#: reference_output.xml:791 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.25" msgstr "" #. Tag: programlisting -#: reference_output.xml:780 +#: reference_output.xml:799 #, no-c-format msgid "" "SELECT ST_AsText('01030000000100000005000000000000000000\n" @@ -1327,73 +1357,73 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:787 +#: reference_output.xml:806 reference_output.xml:929 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_output.xml:794 +#: reference_output.xml:813 #, no-c-format msgid "ST_AsLatLonText" msgstr "" #. Tag: refpurpose -#: reference_output.xml:795 +#: reference_output.xml:814 #, no-c-format msgid "Return the Degrees, Minutes, Seconds representation of the given point." msgstr "" -#. Tag: funcsynopsis -#: reference_output.xml:799 +#. Tag: funcprototype +#: reference_output.xml:819 #, no-c-format -msgid " text ST_AsLatLonText geometry pt text ST_AsLatLonText geometry pt text format " +msgid "text ST_AsLatLonText geometry pt text format=''" msgstr "" #. Tag: para -#: reference_output.xml:815 +#: reference_output.xml:830 #, no-c-format msgid "Returns the Degrees, Minutes, Seconds representation of the point." msgstr "" #. Tag: para -#: reference_output.xml:818 +#: reference_output.xml:833 #, no-c-format msgid "It is assumed the point is in a lat/lon projection. The X (lon) and Y (lat) coordinates are normalized in the output to the \"normal\" range (-180 to +180 for lon, -90 to +90 for lat)." msgstr "" #. Tag: para -#: reference_output.xml:821 +#: reference_output.xml:836 #, no-c-format msgid "The text parameter is a format string containing the format for the resulting text, similar to a date format string. Valid tokens are \"D\" for degrees, \"M\" for minutes, \"S\" for seconds, and \"C\" for cardinal direction (NSEW). DMS tokens may be repeated to indicate desired width and precision (\"SSS.SSSS\" means \" 1.0023\")." msgstr "" #. Tag: para -#: reference_output.xml:826 +#: reference_output.xml:841 #, no-c-format msgid "\"M\", \"S\", and \"C\" are optional. If \"C\" is omitted, degrees are shown with a \"-\" sign if south or west. If \"S\" is omitted, minutes will be shown as decimal with as many digits of precision as you specify. If \"M\" is also omitted, degrees are shown as decimal with as many digits precision as you specify." msgstr "" #. Tag: para -#: reference_output.xml:831 +#: reference_output.xml:846 #, no-c-format msgid "If the format string is omitted (or zero-length) a default format will be used." msgstr "" #. Tag: para -#: reference_output.xml:837 +#: reference_output.xml:852 #, no-c-format msgid "Availability: 2.0" msgstr "" #. Tag: para -#: reference_output.xml:843 +#: reference_output.xml:858 #, no-c-format msgid "Default format." msgstr "" #. Tag: programlisting -#: reference_output.xml:844 +#: reference_output.xml:859 #, no-c-format msgid "" "SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)'));\n" @@ -1403,13 +1433,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:845 +#: reference_output.xml:860 #, no-c-format msgid "Providing a format (same as the default)." msgstr "" #. Tag: programlisting -#: reference_output.xml:846 +#: reference_output.xml:861 #, no-c-format msgid "" "SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D°M''S.SSS\"C'));\n" @@ -1419,13 +1449,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:847 +#: reference_output.xml:862 #, no-c-format msgid "Characters other than D, M, S, C and . are just passed through." msgstr "" #. Tag: programlisting -#: reference_output.xml:848 +#: reference_output.xml:863 #, no-c-format msgid "" "SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D degrees, M minutes, S seconds to the C'));\n" @@ -1435,13 +1465,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:849 +#: reference_output.xml:864 #, no-c-format msgid "Signed degrees instead of cardinal directions." msgstr "" #. Tag: programlisting -#: reference_output.xml:850 +#: reference_output.xml:865 #, no-c-format msgid "" "SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D°M''S.SSS\"'));\n" @@ -1451,13 +1481,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:851 +#: reference_output.xml:866 #, no-c-format msgid "Decimal degrees." msgstr "" #. Tag: programlisting -#: reference_output.xml:852 +#: reference_output.xml:867 #, no-c-format msgid "" "SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D.DDDD degrees C'));\n" @@ -1467,13 +1497,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:853 +#: reference_output.xml:868 #, no-c-format msgid "Excessively large values are normalized." msgstr "" #. Tag: programlisting -#: reference_output.xml:854 +#: reference_output.xml:869 #, no-c-format msgid "" "SELECT (ST_AsLatLonText('POINT (-302.2342342 -792.32498)'));\n" @@ -1483,150 +1513,111 @@ msgid "" msgstr "" #. Tag: refname -#: reference_output.xml:862 +#: reference_output.xml:877 #, no-c-format msgid "ST_AsTWKB" msgstr "" #. Tag: refpurpose -#: reference_output.xml:863 +#: reference_output.xml:878 #, no-c-format -msgid "Returns the geometry as TWKB, Tiny WKB" +msgid "Returns the geometry as TWKB, aka \"Tiny Well-Known Binary\"" msgstr "" -#. Tag: funcprototype -#: reference_output.xml:868 -#, no-c-format -msgid "bytea ST_AsTWKB geometry g1 integer decimaldigits int8 geometryID=null boolean include sizes=false boolean include bounding boxes=false" -msgstr "" - -#. Tag: para -#: reference_output.xml:880 reference_output.xml:946 +#. Tag: funcsynopsis +#: reference_output.xml:882 #, no-c-format -msgid "Returns the geometry in TWKB format. TWKB is a new compressed binary format." +msgid " bytea ST_AsTWKB geometry g1 integer decimaldigits_xy=0 integer decimaldigits_z=0 integer decimaldigits_m=0 boolean include_sizes=false boolean include_bounding boxes=false bytea ST_AsTWKB geometry[] geometries bigint[] unique_ids integer decimaldigits_xy=0 integer decimaldigits_z=0 integer decimaldigits_m=0 boolean include_sizes=false boolean include_bounding_boxes=false " msgstr "" #. Tag: para -#: reference_output.xml:881 reference_output.xml:948 +#: reference_output.xml:906 #, no-c-format -msgid "The second parameter is an integer used to define the number of coordinate decimals in the output." +msgid "Returns the geometry in TWKB (Tiny Well-Known Binary) format. TWKB is a compressed binary format with a focus on minimizing the size of the output." msgstr "" #. Tag: para -#: reference_output.xml:882 reference_output.xml:949 +#: reference_output.xml:907 #, no-c-format -msgid "The third parameter is optional. It is used to give each TWKB-geometry an unique ID" +msgid "The decimal digits parameters control how much precision is stored in the output. By default, values are rounded to the nearest unit before encoding. If you want to transfer more precision, increase the number. For example, a value of 1 implies that the first digit to the right of the decimal point will be preserved." msgstr "" #. Tag: para -#: reference_output.xml:883 reference_output.xml:950 +#: reference_output.xml:908 #, no-c-format -msgid "The fourth parameter is optional. If it is set to true, the size of the geometry is included" +msgid "The sizes and bounding boxes parameters control whether optional information about the encoded length of the object and the bounds of the object are included in the output. By default they are not. Do not turn them on unless your client software has a use for them, as they just use up space (and saving space is the point of TWKB)." msgstr "" #. Tag: para -#: reference_output.xml:885 +#: reference_output.xml:909 #, no-c-format -msgid "TWKB is still a moving target. The format is described https://github.com/TWKB/Specification , and code for building a client can be found https://github.com/TWKB/twkb.js" +msgid "The array-input form of the function is used to convert a collection of geometries and unique identifiers into a TWKB collection that preserves the identifiers. This is useful for clients that expect to unpack a collection and then access further information about the objects inside. You can create the arrays using the array_agg function. The other parameters operate the same as for the simple form of the function." msgstr "" #. Tag: para -#: reference_output.xml:888 +#: reference_output.xml:911 #, no-c-format -msgid "TWKB doesn't make any difference of Z and M. So PointM and PointZ will give the same twkb representation." +msgid "The format specification is available online at https://github.com/TWKB/Specification, and code for building a JavaScript client can be found at https://github.com/TWKB/twkb.js." msgstr "" #. Tag: para -#: reference_output.xml:891 reference_output.xml:956 reference_output.xml:993 +#: reference_output.xml:914 reference_output.xml:957 #, no-c-format msgid "Availability: 2.2.0" msgstr "" #. Tag: programlisting -#: reference_output.xml:897 +#: reference_output.xml:920 #, no-c-format msgid "" - "SELECT ST_AsTWKB('LINESTRING(1 1,5 5)'::geometry,0,1);\n" + "SELECT ST_AsTWKB('LINESTRING(1 1,5 5)'::geometry);\n" " st_astwkb \n" "--------------------------------------------\n" - "\\x0142020202020808" + "\\x02000202020808" msgstr "" #. Tag: para -#: reference_output.xml:902 reference_output.xml:967 +#: reference_output.xml:921 #, no-c-format -msgid ", , , , " -msgstr "" - -#. Tag: refname -#: reference_output.xml:908 -#, no-c-format -msgid "ST_AsTWKBAgg" -msgstr "" - -#. Tag: refpurpose -#: reference_output.xml:909 -#, no-c-format -msgid "Aggregates the geometries and returns as TWKB" -msgstr "" - -#. Tag: funcsynopsis -#: reference_output.xml:913 -#, no-c-format -msgid " bytea ST_AsTWKBAgg geometry set g1 integer decimaldigits bytea ST_AsTWKBAgg geometry set g1 integer decimaldigits int8 geometryID bytea ST_AsTWKBAgg geometry set g1 integer decimaldigits int8 geometryID boolean include sizes bytea ST_AsTWKBAgg geometry set g1 integer decimaldigits int8 geometryID boolean include sizes boolean include bounding boxes " -msgstr "" - -#. Tag: para -#: reference_output.xml:947 -#, no-c-format -msgid "This is the aggregate version of ST_AsTWKB. It aggregates and returns the geometry in TWKB-format. In the resulting TWKB-geometry each individual ID of the input geometries is stored." -msgstr "" - -#. Tag: para -#: reference_output.xml:952 -#, no-c-format -msgid "TWKB is still a moving target. The format is described https://github.com/nicklasaven/TWKB , and code for building a client can be found https://github.com/nicklasaven/twkb_web" +msgid "To create an aggregate TWKB object including identifiers aggregate the desired geometries and objects first, using \"array_agg()\", then call the appropriate TWKB function." msgstr "" #. Tag: programlisting -#: reference_output.xml:962 +#: reference_output.xml:923 #, no-c-format msgid "" - "SELECT ST_AsTWKBAgg(geom,0,id) FROM\n" - "(SELECT 'LINESTRING(1 1,5 5)'::geometry geom, 1 AS id\n" - "UNION ALL\n" - "SELECT 'LINESTRING(6 5, 1 7)'::geometry AS geom, 2 AS id) foo;\n" - " st_astwkbagg \n" - "----------------------------------------------------------------------------\n" - "\\x015602020202020808040202000904" + "SELECT ST_AsTWKB(array_agg(geom), array_agg(gid)) FROM mytable;\n" + " st_astwkb \n" + "--------------------------------------------\n" + "\\x040402020400000202" msgstr "" #. Tag: refname -#: reference_output.xml:973 +#: reference_output.xml:937 #, no-c-format msgid "ST_AsEncodedPolyline" msgstr "" #. Tag: refpurpose -#: reference_output.xml:974 +#: reference_output.xml:938 #, no-c-format msgid "Returns an Encoded Polyline from a LineString geometry." msgstr "" #. Tag: funcprototype -#: reference_output.xml:979 +#: reference_output.xml:943 #, no-c-format msgid "text ST_AsEncodedPolyline geometry geom integer precision=5" msgstr "" #. Tag: para -#: reference_output.xml:990 +#: reference_output.xml:954 #, no-c-format msgid "Returns the geometry as an Encoded Polyline." msgstr "" #. Tag: programlisting -#: reference_output.xml:998 +#: reference_output.xml:962 #, no-c-format msgid "" "ST_AsEncodedPolyline(GeomFromEWKT('SRID=4326;LINESTRING(-120.2 38.5,-120.95 40.7,-126.453 43.252)'));\n" diff --git a/doc/po/templates/reference_processing.xml.pot b/doc/po/templates/reference_processing.xml.pot index 8fafb1094..68abcdeb5 100644 --- a/doc/po/templates/reference_processing.xml.pot +++ b/doc/po/templates/reference_processing.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -29,143 +29,143 @@ msgstr "" #. Tag: refpurpose #: reference_processing.xml:8 #, no-c-format -msgid "(T) For geometry: Returns a geometry that represents all points whose distance from this Geometry is less than or equal to distance. Calculations are in the Spatial Reference System of this Geometry. For geography: Uses a planar transform wrapper. Introduced in 1.5 support for different end cap and mitre settings to control shape. buffer_style options: quad_segs=#,endcap=round|flat|square,join=round|mitre|bevel,mitre_limit=#.#" +msgid "Returns a geometry covering all points within a given distance from the input geometry." msgstr "" #. Tag: funcsynopsis -#: reference_processing.xml:16 +#: reference_processing.xml:15 #, no-c-format msgid " geometry ST_Buffer geometry g1 float radius_of_buffer geometry ST_Buffer geometry g1 float radius_of_buffer integer num_seg_quarter_circle geometry ST_Buffer geometry g1 float radius_of_buffer text buffer_style_parameters geography ST_Buffer geography g1 float radius_of_buffer_in_meters " msgstr "" #. Tag: title -#: reference_processing.xml:47 reference_processing.xml:221 reference_processing.xml:300 reference_processing.xml:355 reference_processing.xml:421 reference_processing.xml:570 reference_processing.xml:638 reference_processing.xml:686 reference_processing.xml:785 reference_processing.xml:865 reference_processing.xml:923 reference_processing.xml:992 reference_processing.xml:1039 reference_processing.xml:1091 reference_processing.xml:1156 reference_processing.xml:1198 reference_processing.xml:1257 reference_processing.xml:1304 reference_processing.xml:1363 reference_processing.xml:1415 reference_processing.xml:1469 reference_processing.xml:1622 reference_processing.xml:1658 reference_processing.xml:1735 reference_processing.xml:1785 reference_processing.xml:1830 reference_processing.xml:1872 reference_processing.xml:1984 reference_processing.xml:2077 reference_processing.xml:2146 +#: reference_processing.xml:46 reference_processing.xml:220 reference_processing.xml:299 reference_processing.xml:354 reference_processing.xml:420 reference_processing.xml:569 reference_processing.xml:637 reference_processing.xml:685 reference_processing.xml:784 reference_processing.xml:864 reference_processing.xml:922 reference_processing.xml:991 reference_processing.xml:1038 reference_processing.xml:1080 reference_processing.xml:1144 reference_processing.xml:1209 reference_processing.xml:1251 reference_processing.xml:1310 reference_processing.xml:1357 reference_processing.xml:1416 reference_processing.xml:1468 reference_processing.xml:1522 reference_processing.xml:1676 reference_processing.xml:1714 reference_processing.xml:1791 reference_processing.xml:1842 reference_processing.xml:1887 reference_processing.xml:1929 reference_processing.xml:1970 reference_processing.xml:2023 reference_processing.xml:2149 reference_processing.xml:2233 reference_processing.xml:2325 reference_processing.xml:2394 reference_processing.xml:2426 reference_processing.xml:2458 #, no-c-format msgid "Description" msgstr "" #. Tag: para -#: reference_processing.xml:49 +#: reference_processing.xml:48 #, no-c-format msgid "Returns a geometry/geography that represents all points whose distance from this Geometry/geography is less than or equal to distance." msgstr "" #. Tag: para -#: reference_processing.xml:51 +#: reference_processing.xml:50 #, no-c-format msgid "Geometry: Calculations are in the Spatial Reference System of the geometry. Introduced in 1.5 support for different end cap and mitre settings to control shape." msgstr "" #. Tag: para -#: reference_processing.xml:54 +#: reference_processing.xml:53 #, no-c-format msgid "Negative radii: For polygons, a negative radius can be used, which will shrink the polygon rather than expanding it." msgstr "" #. Tag: para -#: reference_processing.xml:55 +#: reference_processing.xml:54 #, no-c-format msgid "Geography: For geography this is really a thin wrapper around the geometry implementation. It first determines the best SRID that fits the bounding box of the geography object (favoring UTM, Lambert Azimuthal Equal Area (LAEA) north/south pole, and falling back on mercator in worst case scenario) and then buffers in that planar spatial ref and retransforms back to WGS84 geography." msgstr "" #. Tag: para -#: reference_processing.xml:57 +#: reference_processing.xml:56 #, no-c-format msgid "For geography this may not behave as expected if object is sufficiently large that it falls between two UTM zones or crosses the dateline" msgstr "" #. Tag: para -#: reference_processing.xml:59 +#: reference_processing.xml:58 #, no-c-format msgid "Availability: 1.5 - ST_Buffer was enhanced to support different endcaps and join types. These are useful for example to convert road linestrings into polygon roads with flat or square edges instead of rounded edges. Thin wrapper for geography was added. - requires GEOS >= 3.2 to take advantage of advanced geometry functionality." msgstr "" #. Tag: para -#: reference_processing.xml:62 +#: reference_processing.xml:61 #, no-c-format msgid "The optional third parameter (currently only applies to geometry) can either specify number of segments used to approximate a quarter circle (integer case, defaults to 8) or a list of blank-separated key=value pairs (string case) to tweak operations as follows:" msgstr "" #. Tag: para -#: reference_processing.xml:66 reference_processing.xml:1492 +#: reference_processing.xml:65 reference_processing.xml:1545 #, no-c-format msgid "'quad_segs=#' : number of segments used to approximate a quarter circle (defaults to 8)." msgstr "" #. Tag: para -#: reference_processing.xml:69 +#: reference_processing.xml:68 #, no-c-format msgid "'endcap=round|flat|square' : endcap style (defaults to \"round\", needs GEOS-3.2 or higher for a different value). 'butt' is also accepted as a synonym for 'flat'." msgstr "" #. Tag: para -#: reference_processing.xml:72 +#: reference_processing.xml:71 #, no-c-format msgid "'join=round|mitre|bevel' : join style (defaults to \"round\", needs GEOS-3.2 or higher for a different value). 'miter' is also accepted as a synonym for 'mitre'." msgstr "" #. Tag: para -#: reference_processing.xml:75 +#: reference_processing.xml:74 #, no-c-format msgid "'mitre_limit=#.#' : mitre ratio limit (only affects mitered join style). 'miter_limit' is also accepted as a synonym for 'mitre_limit'." msgstr "" #. Tag: para -#: reference_processing.xml:80 +#: reference_processing.xml:79 #, no-c-format msgid "Units of radius are measured in units of the spatial reference system." msgstr "" #. Tag: para -#: reference_processing.xml:81 +#: reference_processing.xml:80 #, no-c-format msgid "The inputs can be POINTS, MULTIPOINTS, LINESTRINGS, MULTILINESTRINGS, POLYGONS, MULTIPOLYGONS, and GeometryCollections." msgstr "" #. Tag: para -#: reference_processing.xml:82 +#: reference_processing.xml:81 #, no-c-format msgid "This function ignores the third dimension (z) and will always give a 2-d buffer even when presented with a 3d-geometry." msgstr "" #. Tag: para -#: reference_processing.xml:84 reference_processing.xml:309 reference_processing.xml:1509 reference_processing.xml:1839 reference_processing.xml:2097 +#: reference_processing.xml:83 reference_processing.xml:308 reference_processing.xml:1562 reference_processing.xml:1896 reference_processing.xml:2345 #, no-c-format msgid "Performed by the GEOS module." msgstr "" #. Tag: para -#: reference_processing.xml:85 reference_processing.xml:589 reference_processing.xml:796 reference_processing.xml:1116 reference_processing.xml:1995 reference_processing.xml:2106 +#: reference_processing.xml:84 reference_processing.xml:588 reference_processing.xml:795 reference_processing.xml:1169 reference_processing.xml:2160 reference_processing.xml:2354 #, no-c-format msgid "&sfs_compliant; s2.1.1.3" msgstr "" #. Tag: para -#: reference_processing.xml:86 +#: reference_processing.xml:85 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.17" msgstr "" #. Tag: para -#: reference_processing.xml:88 +#: reference_processing.xml:87 #, no-c-format msgid "People often make the mistake of using this function to try to do radius searches. Creating a buffer to to a radius search is slow and pointless. Use instead." msgstr "" #. Tag: title -#: reference_processing.xml:93 reference_processing.xml:238 reference_processing.xml:317 reference_processing.xml:391 reference_processing.xml:459 reference_processing.xml:595 reference_processing.xml:652 reference_processing.xml:803 reference_processing.xml:1007 reference_processing.xml:1120 reference_processing.xml:1273 reference_processing.xml:1321 reference_processing.xml:1432 reference_processing.xml:1518 reference_processing.xml:1755 reference_processing.xml:1801 reference_processing.xml:1845 reference_processing.xml:1888 reference_processing.xml:2003 reference_processing.xml:2113 +#: reference_processing.xml:92 reference_processing.xml:237 reference_processing.xml:316 reference_processing.xml:390 reference_processing.xml:458 reference_processing.xml:594 reference_processing.xml:651 reference_processing.xml:802 reference_processing.xml:1006 reference_processing.xml:1173 reference_processing.xml:1326 reference_processing.xml:1374 reference_processing.xml:1485 reference_processing.xml:1571 reference_processing.xml:1812 reference_processing.xml:1858 reference_processing.xml:1902 reference_processing.xml:1942 reference_processing.xml:1996 reference_processing.xml:2046 reference_processing.xml:2168 reference_processing.xml:2252 reference_processing.xml:2361 reference_processing.xml:2402 reference_processing.xml:2434 #, no-c-format msgid "Examples" msgstr "" #. Tag: para -#: reference_processing.xml:104 +#: reference_processing.xml:103 #, no-c-format msgid "quad_segs=8 (default)" msgstr "" #. Tag: programlisting -#: reference_processing.xml:107 +#: reference_processing.xml:106 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -174,13 +174,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:115 +#: reference_processing.xml:114 #, no-c-format msgid "quad_segs=2 (lame)" msgstr "" #. Tag: programlisting -#: reference_processing.xml:118 +#: reference_processing.xml:117 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -189,13 +189,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:127 +#: reference_processing.xml:126 #, no-c-format msgid "endcap=round join=round (default)" msgstr "" #. Tag: programlisting -#: reference_processing.xml:130 +#: reference_processing.xml:129 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -205,13 +205,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:138 +#: reference_processing.xml:137 #, no-c-format msgid "endcap=square" msgstr "" #. Tag: programlisting -#: reference_processing.xml:141 +#: reference_processing.xml:140 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -221,13 +221,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:149 +#: reference_processing.xml:148 #, no-c-format msgid "endcap=flat" msgstr "" #. Tag: programlisting -#: reference_processing.xml:152 +#: reference_processing.xml:151 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -237,13 +237,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:161 +#: reference_processing.xml:160 #, no-c-format msgid "join=bevel" msgstr "" #. Tag: programlisting -#: reference_processing.xml:164 +#: reference_processing.xml:163 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -253,13 +253,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:172 +#: reference_processing.xml:171 #, no-c-format msgid "join=mitre mitre_limit=5.0 (default mitre limit)" msgstr "" #. Tag: programlisting -#: reference_processing.xml:175 +#: reference_processing.xml:174 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -269,13 +269,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:183 +#: reference_processing.xml:182 #, no-c-format msgid "join=mitre mitre_limit=1" msgstr "" #. Tag: programlisting -#: reference_processing.xml:186 +#: reference_processing.xml:185 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -285,7 +285,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:193 +#: reference_processing.xml:192 #, no-c-format msgid "" "--A buffered point approximates a circle\n" @@ -315,67 +315,67 @@ msgid "" msgstr "" #. Tag: title -#: reference_processing.xml:197 reference_processing.xml:272 reference_processing.xml:321 reference_processing.xml:398 reference_processing.xml:548 reference_processing.xml:611 reference_processing.xml:659 reference_processing.xml:760 reference_processing.xml:843 reference_processing.xml:902 reference_processing.xml:970 reference_processing.xml:1014 reference_processing.xml:1134 reference_processing.xml:1176 reference_processing.xml:1230 reference_processing.xml:1280 reference_processing.xml:1334 reference_processing.xml:1387 reference_processing.xml:1438 reference_processing.xml:1600 reference_processing.xml:1636 reference_processing.xml:1706 reference_processing.xml:1762 reference_processing.xml:1806 reference_processing.xml:1850 reference_processing.xml:1959 reference_processing.xml:2044 reference_processing.xml:2120 reference_processing.xml:2174 +#: reference_processing.xml:196 reference_processing.xml:271 reference_processing.xml:320 reference_processing.xml:397 reference_processing.xml:547 reference_processing.xml:610 reference_processing.xml:658 reference_processing.xml:759 reference_processing.xml:842 reference_processing.xml:901 reference_processing.xml:969 reference_processing.xml:1013 reference_processing.xml:1055 reference_processing.xml:1103 reference_processing.xml:1187 reference_processing.xml:1229 reference_processing.xml:1283 reference_processing.xml:1333 reference_processing.xml:1387 reference_processing.xml:1440 reference_processing.xml:1491 reference_processing.xml:1653 reference_processing.xml:1692 reference_processing.xml:1762 reference_processing.xml:1819 reference_processing.xml:1863 reference_processing.xml:1907 reference_processing.xml:1947 reference_processing.xml:2001 reference_processing.xml:2117 reference_processing.xml:2209 reference_processing.xml:2287 reference_processing.xml:2368 reference_processing.xml:2486 #, no-c-format msgid "See Also" msgstr "" #. Tag: para -#: reference_processing.xml:199 +#: reference_processing.xml:198 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_processing.xml:205 +#: reference_processing.xml:204 #, no-c-format msgid "ST_BuildArea" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:207 +#: reference_processing.xml:206 #, no-c-format msgid "Creates an areal geometry formed by the constituent linework of given geometry" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:213 +#: reference_processing.xml:212 #, no-c-format msgid "geometry ST_BuildArea geometry A" msgstr "" #. Tag: para -#: reference_processing.xml:223 +#: reference_processing.xml:222 #, no-c-format msgid "Creates an areal geometry formed by the constituent linework of given geometry. The return type can be a Polygon or MultiPolygon, depending on input. If the input lineworks do not form polygons NULL is returned. The inputs can be LINESTRINGS, MULTILINESTRINGS, POLYGONS, MULTIPOLYGONS, and GeometryCollections." msgstr "" #. Tag: para -#: reference_processing.xml:228 +#: reference_processing.xml:227 #, no-c-format msgid "This function will assume all inner geometries represent holes" msgstr "" #. Tag: para -#: reference_processing.xml:231 reference_processing.xml:1375 +#: reference_processing.xml:230 reference_processing.xml:1428 #, no-c-format msgid "Input linework must be correctly noded for this function to work properly" msgstr "" #. Tag: para -#: reference_processing.xml:234 +#: reference_processing.xml:233 #, no-c-format msgid "Availability: 1.1.0 - requires GEOS >= 2.1.0." msgstr "" #. Tag: para -#: reference_processing.xml:248 +#: reference_processing.xml:247 #, no-c-format msgid "This will create a donut" msgstr "" #. Tag: programlisting -#: reference_processing.xml:251 +#: reference_processing.xml:250 #, no-c-format msgid "" "SELECT ST_BuildArea(ST_Collect(smallc,bigc))\n" @@ -386,13 +386,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:260 +#: reference_processing.xml:259 #, no-c-format msgid "This will create a gaping hole inside the circle with prongs sticking out" msgstr "" #. Tag: programlisting -#: reference_processing.xml:263 +#: reference_processing.xml:262 #, no-c-format msgid "" "SELECT ST_BuildArea(ST_Collect(line,circle))\n" @@ -414,49 +414,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:274 +#: reference_processing.xml:273 #, no-c-format msgid ", , , wrappers to this function with standard OGC interface" msgstr "" #. Tag: refname -#: reference_processing.xml:285 +#: reference_processing.xml:284 #, no-c-format msgid "ST_ClipByBox2D" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:286 +#: reference_processing.xml:285 #, no-c-format msgid "Returns the portion of a geometry falling within a rectangle." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:291 +#: reference_processing.xml:290 #, no-c-format msgid "geometry ST_ClipByBox2D geometry geom box2d box" msgstr "" #. Tag: para -#: reference_processing.xml:302 +#: reference_processing.xml:301 #, 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." msgstr "" #. Tag: para -#: reference_processing.xml:310 +#: reference_processing.xml:309 reference_processing.xml:2245 #, no-c-format msgid "Requires GEOS 3.5.0+" msgstr "" #. Tag: para -#: reference_processing.xml:312 +#: reference_processing.xml:311 #, no-c-format -msgid "Availability: 2.2.0." +msgid "Availability: 2.2.0 - requires GEOS >= 3.5.0." msgstr "" #. Tag: programlisting -#: reference_processing.xml:318 +#: reference_processing.xml:317 #, no-c-format msgid "" "-- Rely on implicit cast from geometry to box2d for the second parameter\n" @@ -464,79 +464,79 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:322 +#: reference_processing.xml:321 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_processing.xml:332 +#: reference_processing.xml:331 #, no-c-format msgid "ST_Collect" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:333 +#: reference_processing.xml:332 #, no-c-format msgid "Return a specified ST_Geometry value from a collection of other geometries." msgstr "" #. Tag: funcsynopsis -#: reference_processing.xml:337 +#: reference_processing.xml:336 #, no-c-format msgid " geometry ST_Collect geometry set g1field geometry ST_Collect geometry g1 geometry g2 geometry ST_Collect geometry[] g1_array " msgstr "" #. Tag: para -#: reference_processing.xml:356 +#: reference_processing.xml:355 #, no-c-format msgid "Output type can be a MULTI* or a GEOMETRYCOLLECTION. Comes in 2 variants. Variant 1 collects 2 geometries. Variant 2 is an aggregate function that takes a set of geometries and collects them into a single ST_Geometry." msgstr "" #. Tag: para -#: reference_processing.xml:360 +#: reference_processing.xml:359 #, no-c-format msgid "Aggregate version: This function returns a GEOMETRYCOLLECTION or a MULTI object from a set of geometries. The ST_Collect() function is an \"aggregate\" function in the terminology of PostgreSQL. That means that it operates on rows of data, in the same way the SUM() and AVG() functions do. For example, \"SELECT ST_Collect(GEOM) FROM GEOMTABLE GROUP BY ATTRCOLUMN\" will return a separate GEOMETRYCOLLECTION for each distinct value of ATTRCOLUMN." msgstr "" #. Tag: para -#: reference_processing.xml:368 +#: reference_processing.xml:367 #, no-c-format msgid "Non-Aggregate version: This function returns a geometry being a collection of two input geometries. Output type can be a MULTI* or a GEOMETRYCOLLECTION." msgstr "" #. Tag: para -#: reference_processing.xml:372 +#: reference_processing.xml:371 #, no-c-format msgid "ST_Collect and ST_Union are often interchangeable. ST_Collect is in general orders of magnitude faster than ST_Union because it does not try to dissolve boundaries or validate that a constructed MultiPolgon doesn't have overlapping regions. It merely rolls up single geometries into MULTI and MULTI or mixed geometry types into Geometry Collections. Unfortunately geometry collections are not well-supported by GIS tools. To prevent ST_Collect from returning a Geometry Collection when collecting MULTI geometries, one can use the below trick that utilizes to expand the MULTIs out to singles and then regroup them." msgstr "" #. Tag: para -#: reference_processing.xml:383 +#: reference_processing.xml:382 #, no-c-format msgid "Availability: 1.4.0 - ST_Collect(geomarray) was introduced. ST_Collect was enhanced to handle more geometries faster." msgstr "" #. Tag: para -#: reference_processing.xml:384 reference_processing.xml:591 reference_processing.xml:646 reference_processing.xml:698 reference_processing.xml:889 reference_processing.xml:944 reference_processing.xml:1002 reference_processing.xml:1042 reference_processing.xml:1161 reference_processing.xml:1225 reference_processing.xml:1268 reference_processing.xml:1422 reference_processing.xml:1632 reference_processing.xml:1747 reference_processing.xml:2166 +#: reference_processing.xml:383 reference_processing.xml:590 reference_processing.xml:645 reference_processing.xml:697 reference_processing.xml:888 reference_processing.xml:943 reference_processing.xml:1001 reference_processing.xml:1042 reference_processing.xml:1090 reference_processing.xml:1214 reference_processing.xml:1278 reference_processing.xml:1321 reference_processing.xml:1475 reference_processing.xml:1688 reference_processing.xml:1803 reference_processing.xml:2478 #, no-c-format msgid "&Z_support;" msgstr "" #. Tag: para -#: reference_processing.xml:385 +#: reference_processing.xml:384 #, no-c-format msgid "&curve_support; This method supports Circular Strings and Curves, but will never return a MULTICURVE or MULTI as one would expect and PostGIS does not currently support those." msgstr "" #. Tag: para -#: reference_processing.xml:392 +#: reference_processing.xml:391 #, no-c-format msgid "Aggregate example (http://postgis.refractions.net/pipermail/postgis-users/2008-June/020331.html)" msgstr "" #. Tag: programlisting -#: reference_processing.xml:393 +#: reference_processing.xml:392 #, no-c-format msgid "" "SELECT stusps,\n" @@ -548,13 +548,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:394 reference_processing.xml:2116 +#: reference_processing.xml:393 reference_processing.xml:2364 #, no-c-format msgid "Non-Aggregate example" msgstr "" #. Tag: programlisting -#: reference_processing.xml:395 +#: reference_processing.xml:394 #, no-c-format msgid "" "SELECT ST_AsText(ST_Collect(ST_GeomFromText('POINT(1 2)'),\n" @@ -599,91 +599,91 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:399 +#: reference_processing.xml:398 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_processing.xml:404 +#: reference_processing.xml:403 #, no-c-format msgid "ST_ConcaveHull" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:405 +#: reference_processing.xml:404 #, no-c-format msgid "The concave hull of a geometry represents a possibly concave geometry that encloses all geometries within the set. You can think of it as shrink wrapping." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:411 +#: reference_processing.xml:410 #, no-c-format msgid "geometry ST_ConcaveHull geometry geomA float target_percent boolean allow_holes=false" msgstr "" #. Tag: para -#: reference_processing.xml:422 +#: reference_processing.xml:421 #, no-c-format msgid "The concave hull of a geometry represents a possibly concave geometry that encloses all geometries within the set. Defaults to false for allowing polygons with holes. The result is never higher than a single polygon." msgstr "" #. Tag: para -#: reference_processing.xml:426 +#: reference_processing.xml:425 #, no-c-format msgid "The target_percent is the target percent of area of convex hull the PostGIS solution will try to approach before giving up or exiting. One can think of the concave hull as the geometry you get by vacuum sealing a set of geometries. The target_percent of 1 will give you the same answer as the convex hull. A target_percent between 0 and 0.99 will give you something that should have a smaller area than the convex hull. This is different from a convex hull which is more like wrapping a rubber band around the set of geometries." msgstr "" #. Tag: para -#: reference_processing.xml:431 +#: reference_processing.xml:430 #, no-c-format msgid "It is usually used with MULTI and Geometry Collections. Although it is not an aggregate - you can use it in conjunction with ST_Collect or ST_Union to get the concave hull of a set of points/linestring/polygons ST_ConcaveHull(ST_Collect(somepointfield), 0.80)." msgstr "" #. Tag: para -#: reference_processing.xml:436 +#: reference_processing.xml:435 #, no-c-format msgid "It is much slower to compute than convex hull but encloses the geometry better and is also useful for image recognition." msgstr "" #. Tag: para -#: reference_processing.xml:439 reference_processing.xml:587 reference_processing.xml:792 reference_processing.xml:1111 reference_processing.xml:1991 +#: reference_processing.xml:438 reference_processing.xml:586 reference_processing.xml:791 reference_processing.xml:1164 reference_processing.xml:2156 #, no-c-format msgid "Performed by the GEOS module" msgstr "" #. Tag: para -#: reference_processing.xml:440 +#: reference_processing.xml:439 #, no-c-format msgid "Note - If you are using with points, linestrings, or geometry collections use ST_Collect. If you are using with polygons, use ST_Union since it may fail with invalid geometries." msgstr "" #. Tag: para -#: reference_processing.xml:443 +#: reference_processing.xml:442 #, no-c-format msgid "Note - The smaller you make the target percent, the longer it takes to process the concave hull and more likely to run into topological exceptions. Also the more floating points and number of points you accrue. First try a 0.99 which does a first hop, is usually very fast, sometimes as fast as computing the convex hull, and usually gives much better than 99% of shrink since it almost always overshoots. Second hope of 0.98 it slower, others get slower usually quadratically. To reduce precision and float points, use or after ST_ConcaveHull. ST_SnapToGrid is a bit faster, but could result in invalid geometries where as ST_SimplifyPreserveTopology almost always preserves the validity of the geometry." msgstr "" #. Tag: para -#: reference_processing.xml:448 +#: reference_processing.xml:447 #, no-c-format msgid "More real world examples and brief explanation of the technique are shown http://www.bostongis.com/postgis_concavehull.snippet" msgstr "" #. Tag: para -#: reference_processing.xml:451 +#: reference_processing.xml:450 #, no-c-format msgid "Also check out Simon Greener's article on demonstrating ConcaveHull introduced in Oracle 11G R2. http://www.spatialdbadvisor.com/oracle_spatial_tips_tricks/172/concave-hull-geometries-in-oracle-11gr2. The solution we get at 0.75 target percent of convex hull is similar to the shape Simon gets with Oracle SDO_CONCAVEHULL_BOUNDARY." msgstr "" #. Tag: para -#: reference_processing.xml:455 reference_processing.xml:1044 reference_processing.xml:1630 reference_processing.xml:1883 +#: reference_processing.xml:454 reference_processing.xml:1040 reference_processing.xml:2034 #, no-c-format msgid "Availability: 2.0.0" msgstr "" #. Tag: programlisting -#: reference_processing.xml:460 +#: reference_processing.xml:459 #, no-c-format msgid "" "--Get estimate of infected area based on point observations\n" @@ -694,13 +694,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:470 +#: reference_processing.xml:469 #, no-c-format msgid "ST_ConcaveHull of 2 polygons encased in target 100% shrink concave hull" msgstr "" #. Tag: programlisting -#: reference_processing.xml:473 +#: reference_processing.xml:472 #, no-c-format msgid "" "-- geometries overlaid with concavehull \n" @@ -715,13 +715,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:480 +#: reference_processing.xml:479 #, no-c-format msgid "-- geometries overlaid with concavehull at target 90% of convex hull area" msgstr "" #. Tag: programlisting -#: reference_processing.xml:484 +#: reference_processing.xml:483 #, no-c-format msgid "" "-- geometries overlaid with concavehull at target 90% shrink\n" @@ -735,13 +735,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:493 +#: reference_processing.xml:492 #, no-c-format msgid "L Shape points overlaid with convex hull" msgstr "" #. Tag: programlisting -#: reference_processing.xml:496 +#: reference_processing.xml:495 #, no-c-format msgid "" "-- this produces a table of 42 points that form an L shape\n" @@ -758,13 +758,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:503 +#: reference_processing.xml:502 #, no-c-format msgid "ST_ConcaveHull of L points at target 99% of convex hull" msgstr "" #. Tag: programlisting -#: reference_processing.xml:506 +#: reference_processing.xml:505 #, no-c-format msgid "" "SELECT ST_ConcaveHull(ST_Collect(geom), 0.99)\n" @@ -772,13 +772,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:515 +#: reference_processing.xml:514 #, no-c-format msgid "Concave Hull of L points at target 80% convex hull area" msgstr "" #. Tag: programlisting -#: reference_processing.xml:518 +#: reference_processing.xml:517 #, no-c-format msgid "" "-- Concave Hull L shape points\n" @@ -788,19 +788,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:527 +#: reference_processing.xml:526 #, no-c-format msgid "multilinestring overlaid with Convex hull" msgstr "" #. Tag: para -#: reference_processing.xml:535 +#: reference_processing.xml:534 #, no-c-format msgid "multilinestring with overlaid with Concave hull of linestrings at 99% target -- first hop" msgstr "" #. Tag: programlisting -#: reference_processing.xml:539 +#: reference_processing.xml:538 #, no-c-format msgid "" "SELECT ST_ConcaveHull(ST_GeomFromText('MULTILINESTRING((106 164,30 112,74 70,82 112,130 94,\n" @@ -814,61 +814,61 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:549 +#: reference_processing.xml:548 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_processing.xml:555 +#: reference_processing.xml:554 #, no-c-format msgid "ST_ConvexHull" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:556 +#: reference_processing.xml:555 #, no-c-format msgid "The convex hull of a geometry represents the minimum convex geometry that encloses all geometries within the set." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:562 +#: reference_processing.xml:561 #, no-c-format msgid "geometry ST_ConvexHull geometry geomA" msgstr "" #. Tag: para -#: reference_processing.xml:571 +#: reference_processing.xml:570 #, no-c-format msgid "The convex hull of a geometry represents the minimum convex geometry that encloses all geometries within the set." msgstr "" #. Tag: para -#: reference_processing.xml:574 +#: reference_processing.xml:573 #, no-c-format msgid "One can think of the convex hull as the geometry you get by wrapping an elastic band around a set of geometries. This is different from a concave hull which is analogous to shrink-wrapping your geometries." msgstr "" #. Tag: para -#: reference_processing.xml:578 +#: reference_processing.xml:577 #, no-c-format msgid "It is usually used with MULTI and Geometry Collections. Although it is not an aggregate - you can use it in conjunction with ST_Collect to get the convex hull of a set of points. ST_ConvexHull(ST_Collect(somepointfield))." msgstr "" #. Tag: para -#: reference_processing.xml:583 +#: reference_processing.xml:582 #, no-c-format msgid "It is often used to determine an affected area based on a set of point observations." msgstr "" #. Tag: para -#: reference_processing.xml:590 +#: reference_processing.xml:589 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.16" msgstr "" #. Tag: programlisting -#: reference_processing.xml:596 +#: reference_processing.xml:595 #, no-c-format msgid "" "--Get estimate of infected area based on point observations\n" @@ -879,13 +879,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:604 +#: reference_processing.xml:603 #, no-c-format msgid "Convex Hull of a MultiLinestring and a MultiPoint seen together with the MultiLinestring and MultiPoint" msgstr "" #. Tag: programlisting -#: reference_processing.xml:607 +#: reference_processing.xml:606 #, no-c-format msgid "" "SELECT ST_AsText(ST_ConvexHull(\n" @@ -898,67 +898,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:612 +#: reference_processing.xml:611 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_processing.xml:618 +#: reference_processing.xml:617 #, no-c-format msgid "ST_CurveToLine" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:620 +#: reference_processing.xml:619 #, no-c-format msgid "Converts a CIRCULARSTRING/CURVEDPOLYGON to a LINESTRING/POLYGON" msgstr "" #. Tag: funcsynopsis -#: reference_processing.xml:624 +#: reference_processing.xml:623 #, no-c-format msgid " geometry ST_CurveToLine geometry curveGeom geometry ST_CurveToLine geometry curveGeom integer segments_per_qtr_circle " msgstr "" #. Tag: para -#: reference_processing.xml:640 +#: reference_processing.xml:639 #, no-c-format msgid "Converst a CIRCULAR STRING to regular LINESTRING or CURVEPOLYGON to POLYGON. Useful for outputting to devices that can't support CIRCULARSTRING geometry types" msgstr "" #. Tag: para -#: reference_processing.xml:641 +#: reference_processing.xml:640 #, no-c-format msgid "Converts a given geometry to a linear geometry. Each curved geometry or segment is converted into a linear approximation using the default value of 32 segments per quarter circle" msgstr "" #. Tag: para -#: reference_processing.xml:643 reference_processing.xml:1160 +#: reference_processing.xml:642 reference_processing.xml:1213 #, no-c-format msgid "Availability: 1.2.2?" msgstr "" #. Tag: para -#: reference_processing.xml:644 +#: reference_processing.xml:643 #, no-c-format msgid "&sfs_compliant;" msgstr "" #. Tag: para -#: reference_processing.xml:645 +#: reference_processing.xml:644 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 7.1.7" msgstr "" #. Tag: para -#: reference_processing.xml:647 reference_processing.xml:886 reference_processing.xml:941 reference_processing.xml:1041 reference_processing.xml:1162 +#: reference_processing.xml:646 reference_processing.xml:885 reference_processing.xml:940 reference_processing.xml:1041 reference_processing.xml:1089 reference_processing.xml:1215 #, no-c-format msgid "&curve_support;" msgstr "" #. Tag: programlisting -#: reference_processing.xml:654 +#: reference_processing.xml:653 #, no-c-format msgid "" "SELECT ST_AsText(ST_CurveToLine(ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 150505,220227 150406)')));\n" @@ -1019,55 +1019,55 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:667 +#: reference_processing.xml:666 #, no-c-format msgid "ST_DelaunayTriangles" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:669 +#: reference_processing.xml:668 #, no-c-format msgid "Return a Delaunay triangulation around the given input points." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:676 +#: reference_processing.xml:675 #, no-c-format msgid "geometry ST_DelaunayTriangles geometry g1 float tolerance int4 flags" msgstr "" #. Tag: para -#: reference_processing.xml:688 +#: reference_processing.xml:687 #, no-c-format msgid "Return a Delaunay triangulation around the vertices of the input geometry. Output is a COLLECTION of polygons (for flags=0) or a MULTILINESTRING (for flags=1) or TIN (for flags=2). The tolerance, if any, is used to snap input vertices togheter." msgstr "" #. Tag: para -#: reference_processing.xml:697 +#: reference_processing.xml:696 #, no-c-format msgid "Availability: 2.1.0 - requires GEOS >= 3.4.0." msgstr "" #. Tag: para -#: reference_processing.xml:699 reference_processing.xml:888 reference_processing.xml:943 reference_processing.xml:1046 reference_processing.xml:1750 +#: reference_processing.xml:698 reference_processing.xml:887 reference_processing.xml:942 reference_processing.xml:1045 reference_processing.xml:1093 reference_processing.xml:1807 #, no-c-format msgid "&T_support;" msgstr "" #. Tag: title -#: reference_processing.xml:703 +#: reference_processing.xml:702 #, no-c-format msgid "2D Examples" msgstr "" #. Tag: para -#: reference_processing.xml:712 +#: reference_processing.xml:711 #, no-c-format msgid "Original polygons" msgstr "" #. Tag: programlisting -#: reference_processing.xml:715 +#: reference_processing.xml:714 #, no-c-format msgid "" "-- our original geometry --\n" @@ -1078,13 +1078,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:723 +#: reference_processing.xml:722 #, no-c-format msgid "ST_DelaunayTriangles of 2 polygons: delaunay triangle polygons each triangle themed in different color" msgstr "" #. Tag: programlisting -#: reference_processing.xml:726 +#: reference_processing.xml:725 #, no-c-format msgid "" "-- geometries overlaid multilinestring triangles\n" @@ -1098,13 +1098,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:733 +#: reference_processing.xml:732 #, no-c-format msgid "-- delaunay triangles as multilinestring" msgstr "" #. Tag: programlisting -#: reference_processing.xml:736 +#: reference_processing.xml:735 #, no-c-format msgid "" "SELECT \n" @@ -1117,13 +1117,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:744 +#: reference_processing.xml:743 #, no-c-format msgid "-- delaunay triangles of 45 points as 55 triangle polygons" msgstr "" #. Tag: programlisting -#: reference_processing.xml:747 +#: reference_processing.xml:746 #, no-c-format msgid "" "-- this produces a table of 42 points that form an L shape\n" @@ -1151,13 +1151,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_processing.xml:756 +#: reference_processing.xml:755 #, no-c-format msgid "3D Examples" msgstr "" #. Tag: programlisting -#: reference_processing.xml:757 +#: reference_processing.xml:756 #, no-c-format msgid "" "-- 3D multipoint --\n" @@ -1171,73 +1171,73 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:761 reference_processing.xml:1388 +#: reference_processing.xml:760 reference_processing.xml:1441 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_processing.xml:768 +#: reference_processing.xml:767 #, no-c-format msgid "ST_Difference" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:770 +#: reference_processing.xml:769 #, no-c-format msgid "Returns a geometry that represents that part of geometry A that does not intersect with geometry B." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:776 +#: reference_processing.xml:775 #, no-c-format msgid "geometry ST_Difference geometry geomA geometry geomB" msgstr "" #. Tag: para -#: reference_processing.xml:787 +#: reference_processing.xml:786 #, no-c-format msgid "Returns a geometry that represents that part of geometry A that does not intersect with geometry B. One can think of this as GeometryA - ST_Intersection(A,B). If A is completely contained in B then an empty geometry collection is returned." msgstr "" #. Tag: para -#: reference_processing.xml:790 +#: reference_processing.xml:789 #, no-c-format msgid "Note - order matters. B - A will always return a portion of B" msgstr "" #. Tag: para -#: reference_processing.xml:794 reference_processing.xml:1993 +#: reference_processing.xml:793 reference_processing.xml:2158 #, no-c-format msgid "Do not call with a GeometryCollection as an argument" msgstr "" #. Tag: para -#: reference_processing.xml:797 +#: reference_processing.xml:796 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.20" msgstr "" #. Tag: para -#: reference_processing.xml:798 reference_processing.xml:1997 +#: reference_processing.xml:797 reference_processing.xml:2162 #, no-c-format msgid "&Z_support; However it seems to only consider x y when doing the difference and tacks back on the Z-Index" msgstr "" #. Tag: para -#: reference_processing.xml:815 +#: reference_processing.xml:814 #, no-c-format msgid "The original linestrings shown together." msgstr "" #. Tag: para -#: reference_processing.xml:827 +#: reference_processing.xml:826 #, no-c-format msgid "The difference of the two linestrings" msgstr "" #. Tag: programlisting -#: reference_processing.xml:836 +#: reference_processing.xml:835 #, no-c-format msgid "" "--Safe for 2d. This is same geometries as what is shown for st_symdifference\n" @@ -1254,7 +1254,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:838 +#: reference_processing.xml:837 #, no-c-format msgid "" "--When used in 3d doesn't quite do the right thing\n" @@ -1265,67 +1265,67 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:851 +#: reference_processing.xml:850 #, no-c-format msgid "ST_Dump" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:852 +#: reference_processing.xml:851 #, 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:857 +#: reference_processing.xml:856 #, no-c-format msgid "geometry_dump[] ST_Dump geometry g1" msgstr "" #. Tag: para -#: reference_processing.xml:866 +#: reference_processing.xml:865 #, 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:875 +#: reference_processing.xml:874 #, 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:879 reference_processing.xml:939 +#: reference_processing.xml:878 reference_processing.xml:938 #, no-c-format msgid "Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced." msgstr "" #. Tag: para -#: reference_processing.xml:880 +#: reference_processing.xml:879 #, no-c-format msgid "Availability: PostGIS 1.0.0RC1. Requires PostgreSQL 7.3 or higher." msgstr "" #. Tag: para -#: reference_processing.xml:882 +#: reference_processing.xml:881 #, 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:887 reference_processing.xml:942 reference_processing.xml:1045 reference_processing.xml:1631 reference_processing.xml:1749 +#: reference_processing.xml:886 reference_processing.xml:941 reference_processing.xml:1044 reference_processing.xml:1092 reference_processing.xml:1687 reference_processing.xml:1806 #, no-c-format msgid "&P_support;" msgstr "" #. Tag: title -#: reference_processing.xml:893 +#: reference_processing.xml:892 #, no-c-format msgid "Standard Examples" msgstr "" #. Tag: programlisting -#: reference_processing.xml:894 +#: reference_processing.xml:893 #, no-c-format msgid "" "SELECT sometable.field1, sometable.field1,\n" @@ -1345,13 +1345,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_processing.xml:896 reference_processing.xml:964 +#: reference_processing.xml:895 reference_processing.xml:963 #, no-c-format msgid "Polyhedral Surfaces, TIN and Triangle Examples" msgstr "" #. Tag: programlisting -#: reference_processing.xml:897 +#: reference_processing.xml:896 #, no-c-format msgid "" "-- Polyhedral surface example\n" @@ -1374,7 +1374,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:899 +#: reference_processing.xml:898 #, no-c-format msgid "" "-- TIN -- \n" @@ -1402,67 +1402,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:903 +#: reference_processing.xml:902 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_processing.xml:909 +#: reference_processing.xml:908 #, no-c-format msgid "ST_DumpPoints" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:910 +#: reference_processing.xml:909 #, no-c-format msgid "Returns a set of geometry_dump (geom,path) rows of all points that make up a geometry." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:915 +#: reference_processing.xml:914 #, no-c-format msgid "geometry_dump[]ST_DumpPoints geometry geom" msgstr "" #. Tag: para -#: reference_processing.xml:924 +#: reference_processing.xml:923 #, 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:927 +#: reference_processing.xml:926 #, no-c-format msgid "The geom component of geometry_dump are all the POINTs that make up the supplied geometry" msgstr "" #. Tag: para -#: reference_processing.xml:930 +#: reference_processing.xml:929 #, 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)." msgstr "" #. Tag: para -#: reference_processing.xml:938 +#: reference_processing.xml:937 #, no-c-format msgid "Enhanced: 2.1.0 Faster speed. Reimplemented as native-C." msgstr "" #. Tag: para -#: reference_processing.xml:940 +#: reference_processing.xml:939 #, no-c-format msgid "Availability: 1.5.0" msgstr "" #. Tag: title -#: reference_processing.xml:947 +#: reference_processing.xml:946 #, no-c-format msgid "Classic Explode a Table of LineStrings into nodes" msgstr "" #. Tag: programlisting -#: reference_processing.xml:948 +#: reference_processing.xml:947 #, no-c-format msgid "" "SELECT edge_id, (dp).path[1] As index, ST_AsText((dp).geom) As wktnode\n" @@ -1483,13 +1483,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_processing.xml:951 +#: reference_processing.xml:950 #, no-c-format msgid "Standard Geometry Examples" msgstr "" #. Tag: programlisting -#: reference_processing.xml:961 +#: reference_processing.xml:960 #, no-c-format msgid "" "SELECT path, ST_AsText(geom) \n" @@ -1547,7 +1547,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:965 +#: reference_processing.xml:964 #, no-c-format msgid "" "-- Polyhedral surface cube -- \n" @@ -1596,7 +1596,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:966 +#: reference_processing.xml:965 #, no-c-format msgid "" "-- Triangle -- \n" @@ -1620,7 +1620,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:967 +#: reference_processing.xml:966 #, no-c-format msgid "" "-- TIN -- \n" @@ -1655,49 +1655,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:971 +#: reference_processing.xml:970 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_processing.xml:976 +#: reference_processing.xml:975 #, no-c-format msgid "ST_DumpRings" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:978 +#: reference_processing.xml:977 #, no-c-format msgid "Returns a set of geometry_dump rows, representing the exterior and interior rings of a polygon." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:984 +#: reference_processing.xml:983 #, no-c-format msgid "geometry_dump[] ST_DumpRings geometry a_polygon" msgstr "" #. Tag: para -#: reference_processing.xml:994 +#: reference_processing.xml:993 #, 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." msgstr "" #. Tag: para -#: reference_processing.xml:1000 +#: reference_processing.xml:999 #, no-c-format msgid "Availability: PostGIS 1.1.3. Requires PostgreSQL 7.3 or higher." msgstr "" #. Tag: para -#: reference_processing.xml:1001 +#: reference_processing.xml:1000 #, no-c-format msgid "This only works for POLYGON geometries. It will not work for MULTIPOLYGONS" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1009 +#: reference_processing.xml:1008 #, no-c-format msgid "" "SELECT sometable.field1, sometable.field1,\n" @@ -1723,49 +1723,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1016 +#: reference_processing.xml:1015 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_processing.xml:1022 +#: reference_processing.xml:1021 #, no-c-format msgid "ST_FlipCoordinates" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1023 +#: reference_processing.xml:1022 #, no-c-format msgid "Returns a version of the given geometry with X and Y axis flipped. Useful for people who have built latitude/longitude features and need to fix them." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1031 +#: reference_processing.xml:1030 #, no-c-format msgid "geometry ST_FlipCoordinates geometry geom" msgstr "" #. Tag: para -#: reference_processing.xml:1040 +#: reference_processing.xml:1039 #, no-c-format msgid "Returns a version of the given geometry with X and Y axis flipped." msgstr "" #. Tag: para -#: reference_processing.xml:1043 +#: reference_processing.xml:1043 reference_processing.xml:1091 #, no-c-format msgid "&M_support;" msgstr "" #. Tag: title -#: reference_processing.xml:1050 +#: reference_processing.xml:1049 reference_processing.xml:1097 #, no-c-format msgid "Example" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1051 +#: reference_processing.xml:1050 #, no-c-format msgid "" "geometry ST_SwapOrdinates geometry geom cstring ords" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1081 +#, no-c-format +msgid "Returns a version of the given geometry with given ordinates swapped." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1084 +#, 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: para +#: reference_processing.xml:1088 reference_processing.xml:1686 reference_processing.xml:1938 reference_processing.xml:1992 +#, no-c-format +msgid "Availability: 2.2.0" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1098 +#, no-c-format +msgid "" + "" +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1111 #, no-c-format msgid "ST_Intersection" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1060 +#: reference_processing.xml:1113 #, no-c-format -msgid "(T) Returns a geometry that represents the shared portion of geomA and geomB. The geography implementation does a transform to geometry to do the intersection and then transform back to WGS84." +msgid "Returns a geometry that represents the shared portion of geomA and geomB." msgstr "" #. Tag: funcsynopsis -#: reference_processing.xml:1065 +#: reference_processing.xml:1118 #, no-c-format msgid " geometry ST_Intersection geometry geomA geometry geomB geography ST_Intersection geography geogA geography geogB " msgstr "" #. Tag: para -#: reference_processing.xml:1092 +#: reference_processing.xml:1145 #, no-c-format msgid "Returns a geometry that represents the point set intersection of the Geometries." msgstr "" #. Tag: para -#: reference_processing.xml:1095 +#: reference_processing.xml:1148 #, no-c-format msgid "In other words - that portion of geometry A and geometry B that is shared between the two geometries." msgstr "" #. Tag: para -#: reference_processing.xml:1098 +#: reference_processing.xml:1151 #, no-c-format msgid "If the geometries do not share any space (are disjoint), then an empty geometry collection is returned." msgstr "" #. Tag: para -#: reference_processing.xml:1100 +#: reference_processing.xml:1153 #, no-c-format msgid "ST_Intersection in conjunction with ST_Intersects is very useful for clipping geometries such as in bounding box, buffer, region queries where you only want to return that portion of a geometry that sits in a country or region of interest." msgstr "" #. Tag: para -#: reference_processing.xml:1103 +#: reference_processing.xml:1156 #, no-c-format msgid "Geography: For geography this is really a thin wrapper around the geometry implementation. It first determines the best SRID that fits the bounding box of the 2 geography objects (if geography objects are within one half zone UTM but not same UTM will pick one of those) (favoring UTM or Lambert Azimuthal Equal Area (LAEA) north/south pole, and falling back on mercator in worst case scenario) and then intersection in that best fit planar spatial ref and retransforms back to WGS84 geography." msgstr "" #. Tag: para -#: reference_processing.xml:1106 +#: reference_processing.xml:1159 #, no-c-format msgid "Do not call with a GEOMETRYCOLLECTION as an argument" msgstr "" #. Tag: para -#: reference_processing.xml:1109 +#: reference_processing.xml:1162 #, 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." msgstr "" #. Tag: para -#: reference_processing.xml:1112 +#: reference_processing.xml:1165 #, no-c-format msgid "&sfcgal_enhanced;" msgstr "" #. Tag: para -#: reference_processing.xml:1114 +#: reference_processing.xml:1167 #, no-c-format msgid "Availability: 1.5 support for geography data type was introduced." msgstr "" #. Tag: para -#: reference_processing.xml:1117 +#: reference_processing.xml:1170 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.18" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1121 +#: reference_processing.xml:1174 #, no-c-format msgid "" "SELECT ST_AsText(ST_Intersection('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 2 )'::geometry));\n" @@ -1896,19 +1952,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_processing.xml:1125 +#: reference_processing.xml:1178 #, no-c-format msgid "Examples: 2.5Dish" msgstr "" #. Tag: para -#: reference_processing.xml:1126 +#: reference_processing.xml:1179 #, 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 ." msgstr "" #. Tag: programlisting -#: reference_processing.xml:1127 +#: reference_processing.xml:1180 #, no-c-format msgid "" "set postgis.backend=geos; \n" @@ -1922,13 +1978,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1129 +#: reference_processing.xml:1182 #, 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" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1131 +#: reference_processing.xml:1184 #, no-c-format msgid "" "set postgis.backend=sfcgal; \n" @@ -1942,43 +1998,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1135 +#: reference_processing.xml:1188 #, no-c-format msgid ", , , , , , , " msgstr "" #. Tag: refname -#: reference_processing.xml:1141 +#: reference_processing.xml:1194 #, no-c-format msgid "ST_LineToCurve" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1143 +#: reference_processing.xml:1196 #, no-c-format msgid "Converts a LINESTRING/POLYGON to a CIRCULARSTRING, CURVED POLYGON" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1148 +#: reference_processing.xml:1201 #, no-c-format msgid "geometry ST_LineToCurve geometry geomANoncircular" msgstr "" #. Tag: para -#: reference_processing.xml:1158 +#: reference_processing.xml:1211 #, no-c-format msgid "Converts plain LINESTRING/POLYGONS to CIRCULAR STRINGs and Curved Polygons. Note much fewer points are needed to describe the curved equivalent." msgstr "" #. Tag: title -#: reference_processing.xml:1167 +#: reference_processing.xml:1220 #, no-c-format msgid "Examples: 2D" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1169 +#: reference_processing.xml:1222 #, no-c-format msgid "" "SELECT ST_AsText(ST_LineToCurve(foo.the_geom)) As curvedastext,ST_AsText(foo.the_geom) As non_curvedastext\n" @@ -2003,151 +2059,151 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:1184 +#: reference_processing.xml:1237 #, no-c-format msgid "ST_MakeValid" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1185 +#: reference_processing.xml:1238 #, no-c-format msgid "Attempts to make an invalid geometry valid without losing vertices." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1190 +#: reference_processing.xml:1243 #, no-c-format msgid "geometry ST_MakeValid geometry input" msgstr "" #. Tag: para -#: reference_processing.xml:1199 +#: reference_processing.xml:1252 #, no-c-format msgid "The function attempts to create a valid representation of a given invalid geometry without losing any of the input vertices. Already-valid geometries are returned without further intervention." msgstr "" #. Tag: para -#: reference_processing.xml:1205 +#: reference_processing.xml:1258 #, no-c-format msgid "Supported inputs are: POINTS, MULTIPOINTS, LINESTRINGS, MULTILINESTRINGS, POLYGONS, MULTIPOLYGONS and GEOMETRYCOLLECTIONS containing any mix of them." msgstr "" #. Tag: para -#: reference_processing.xml:1211 +#: reference_processing.xml:1264 #, no-c-format msgid "In case of full or partial dimensional collapses, the output geometry may be a collection of lower-to-equal dimension geometries or a geometry of lower dimension." msgstr "" #. Tag: para -#: reference_processing.xml:1217 +#: reference_processing.xml:1270 #, no-c-format msgid "Single polygons may become multi-geometries in case of self-intersections." msgstr "" #. Tag: para -#: reference_processing.xml:1221 +#: reference_processing.xml:1274 #, no-c-format msgid "Availability: 2.0.0, requires GEOS-3.3.0" msgstr "" #. Tag: para -#: reference_processing.xml:1222 +#: reference_processing.xml:1275 #, no-c-format msgid "Enhanced: 2.0.1, speed improvements requires GEOS-3.3.4" msgstr "" #. Tag: para -#: reference_processing.xml:1223 +#: reference_processing.xml:1276 #, no-c-format msgid "Enhanced: 2.1.0 added support for GEOMETRYCOLLECTION and MULTIPOINT." msgstr "" #. Tag: refname -#: reference_processing.xml:1240 +#: reference_processing.xml:1293 #, no-c-format msgid "ST_MemUnion" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1242 +#: reference_processing.xml:1295 #, no-c-format msgid "Same as ST_Union, only memory-friendly (uses less memory and more processor time)." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1248 +#: reference_processing.xml:1301 #, no-c-format msgid "geometry ST_MemUnion geometry set geomfield" msgstr "" #. Tag: para -#: reference_processing.xml:1259 +#: reference_processing.xml:1312 #, no-c-format msgid "Some useful description here." msgstr "" #. Tag: para -#: reference_processing.xml:1263 +#: reference_processing.xml:1316 #, no-c-format msgid "Same as ST_Union, only memory-friendly (uses less memory and more processor time). This aggregate function works by unioning the geometries one at a time to previous result as opposed to ST_Union aggregate which first creates an array and then unions" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1275 +#: reference_processing.xml:1328 #, no-c-format msgid "See ST_Union" msgstr "" #. Tag: refname -#: reference_processing.xml:1288 +#: reference_processing.xml:1341 #, no-c-format msgid "ST_MinimumBoundingCircle" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1289 +#: reference_processing.xml:1342 #, no-c-format msgid "Returns the smallest circle polygon that can fully contain a geometry. Default uses 48 segments per quarter circle." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1295 +#: reference_processing.xml:1348 #, no-c-format msgid "geometry ST_MinimumBoundingCircle geometry geomA integer num_segs_per_qt_circ=48" msgstr "" #. Tag: para -#: reference_processing.xml:1305 +#: reference_processing.xml:1358 #, no-c-format msgid "Returns the smallest circle polygon that can fully contain a geometry." msgstr "" #. Tag: para -#: reference_processing.xml:1306 +#: reference_processing.xml:1359 #, no-c-format msgid "The circle is approximated by a polygon with a default of 48 segments per quarter circle. This number can be increased with little performance penalty to obtain a more accurate result." msgstr "" #. Tag: para -#: reference_processing.xml:1308 +#: reference_processing.xml:1361 #, no-c-format msgid "It is often used with MULTI and Geometry Collections. Although it is not an aggregate - you can use it in conjunction with ST_Collect to get the minimum bounding circle of a set of geometries. ST_MinimumBoundingCircle(ST_Collect(somepointfield))." msgstr "" #. Tag: para -#: reference_processing.xml:1313 +#: reference_processing.xml:1366 #, no-c-format msgid "The ratio of the area of a polygon divided by the area of its Minimum Bounding Circle is often referred to as the Roeck test." msgstr "" #. Tag: para -#: reference_processing.xml:1315 +#: reference_processing.xml:1368 #, no-c-format msgid "Availability: 1.4.0 - requires GEOS" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1322 +#: reference_processing.xml:1375 #, no-c-format msgid "" "SELECT d.disease_type,\n" @@ -2157,13 +2213,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1328 +#: reference_processing.xml:1381 #, no-c-format msgid "Minimum bounding circle of a point and linestring. Using 8 segs to approximate a quarter circle" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1331 +#: reference_processing.xml:1384 #, no-c-format msgid "" "SELECT ST_AsText(ST_MinimumBoundingCircle(\n" @@ -2180,55 +2236,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1335 +#: reference_processing.xml:1388 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_processing.xml:1341 +#: reference_processing.xml:1394 #, no-c-format msgid "ST_Polygonize" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1343 +#: reference_processing.xml:1396 #, no-c-format msgid "Aggregate. Creates a GeometryCollection containing possible polygons formed from the constituent linework of a set of geometries." msgstr "" #. Tag: funcsynopsis -#: reference_processing.xml:1349 +#: reference_processing.xml:1402 #, no-c-format msgid " geometry ST_Polygonize geometry set geomfield geometry ST_Polygonize geometry[] geom_array " msgstr "" #. Tag: para -#: reference_processing.xml:1365 +#: reference_processing.xml:1418 #, no-c-format msgid "Creates a GeometryCollection containing possible polygons formed from the constituent linework of a set of geometries." msgstr "" #. Tag: para -#: reference_processing.xml:1370 +#: reference_processing.xml:1423 #, no-c-format msgid "Geometry Collections are often difficult to deal with with third party tools, so use ST_Polygonize in conjunction with to dump the polygons out into individual polygons." msgstr "" #. Tag: para -#: reference_processing.xml:1378 +#: reference_processing.xml:1431 #, no-c-format msgid "Availability: 1.0.0RC1 - requires GEOS >= 2.1.0." msgstr "" #. Tag: title -#: reference_processing.xml:1382 +#: reference_processing.xml:1435 #, no-c-format msgid "Examples: Polygonizing single linestrings" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1383 +#: reference_processing.xml:1436 #, no-c-format msgid "" "SELECT ST_AsEWKT(ST_Polygonize(the_geom_4269)) As geomtextrep\n" @@ -2257,43 +2313,43 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:1397 +#: reference_processing.xml:1450 #, no-c-format msgid "ST_Node" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1399 +#: reference_processing.xml:1452 #, no-c-format msgid "Node a set of linestrings." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1406 +#: reference_processing.xml:1459 #, no-c-format msgid "geometry ST_Node geometry geom" msgstr "" #. Tag: para -#: reference_processing.xml:1417 +#: reference_processing.xml:1470 #, no-c-format msgid "Fully node a set of linestrings using the least possible number of nodes while preserving all of the input ones." msgstr "" #. Tag: para -#: reference_processing.xml:1424 reference_processing.xml:2168 +#: reference_processing.xml:1477 reference_processing.xml:2480 #, no-c-format msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0." msgstr "" #. Tag: para -#: reference_processing.xml:1426 +#: reference_processing.xml:1479 #, no-c-format msgid "Due to a bug in GEOS up to 3.3.1 this function fails to node self-intersecting lines. This is fixed with GEOS 3.3.2 or higher." msgstr "" #. Tag: programlisting -#: reference_processing.xml:1433 +#: reference_processing.xml:1486 #, no-c-format msgid "" "SELECT ST_AsEWKT(\n" @@ -2305,85 +2361,85 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:1448 +#: reference_processing.xml:1501 #, no-c-format msgid "ST_OffsetCurve" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1450 +#: reference_processing.xml:1503 #, no-c-format msgid "Return an offset line at a given distance and side from an input line. Useful for computing parallel lines about a center line" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1458 +#: reference_processing.xml:1511 #, no-c-format msgid "geometry ST_OffsetCurve geometry line float signed_distance text style_parameters=''" msgstr "" #. Tag: para -#: reference_processing.xml:1471 +#: reference_processing.xml:1524 #, no-c-format msgid "Return an offset line at a given distance and side from an input line. All points of the returned geometries are not further than the given distance from the input geometry." msgstr "" #. Tag: para -#: reference_processing.xml:1477 +#: reference_processing.xml:1530 #, no-c-format msgid "For positive distance the offset will be at the left side of the input line and retain the same direction. For a negative distance it'll be at the right side and in the opposite direction." msgstr "" #. Tag: para -#: reference_processing.xml:1483 +#: reference_processing.xml:1536 #, no-c-format msgid "Availability: 2.0 - requires GEOS >= 3.2, improved with GEOS >= 3.3" msgstr "" #. Tag: para -#: reference_processing.xml:1487 +#: reference_processing.xml:1540 #, no-c-format msgid "The optional third parameter allows specifying a list of blank-separated key=value pairs to tweak operations as follows:" msgstr "" #. Tag: para -#: reference_processing.xml:1495 +#: reference_processing.xml:1548 #, 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:1498 +#: reference_processing.xml:1551 #, no-c-format msgid "'mitre_limit=#.#' : mitre ratio limit (only affects mitred join style). 'miter_limit' is also accepted as a synonym for 'mitre_limit'." msgstr "" #. Tag: para -#: reference_processing.xml:1503 +#: reference_processing.xml:1556 #, no-c-format msgid "Units of distance are measured in units of the spatial reference system." msgstr "" #. Tag: para -#: reference_processing.xml:1507 +#: reference_processing.xml:1560 #, no-c-format msgid "The inputs can only be LINESTRINGS." msgstr "" #. Tag: para -#: reference_processing.xml:1511 +#: reference_processing.xml:1564 #, no-c-format msgid "This function ignores the third dimension (z) and will always give a 2-d result even when presented with a 3d-geometry." msgstr "" #. Tag: para -#: reference_processing.xml:1519 +#: reference_processing.xml:1572 #, no-c-format msgid "Compute an open buffer around roads" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1520 +#: reference_processing.xml:1573 #, no-c-format msgid "" "SELECT ST_Union(\n" @@ -2394,13 +2450,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1530 +#: reference_processing.xml:1583 #, no-c-format msgid "15, 'quad_segs=4 join=round' original line and its offset 15 units." msgstr "" #. Tag: programlisting -#: reference_processing.xml:1534 +#: reference_processing.xml:1587 #, no-c-format msgid "" "SELECT ST_AsText(ST_OffsetCurve(ST_GeomFromText(\n" @@ -2417,13 +2473,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1541 +#: reference_processing.xml:1594 #, no-c-format msgid "-15, 'quad_segs=4 join=round' original line and its offset -15 units" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1545 +#: reference_processing.xml:1598 #, no-c-format msgid "" "SELECT ST_AsText(ST_OffsetCurve(geom,\n" @@ -2438,13 +2494,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1554 +#: reference_processing.xml:1607 #, no-c-format msgid "double-offset to get more curvy, note the first reverses direction, so -30 + 15 = -15" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1557 +#: reference_processing.xml:1610 #, no-c-format msgid "" "SELECT ST_AsText(ST_OffsetCurve(ST_OffsetCurve(geom,\n" @@ -2461,13 +2517,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1564 +#: reference_processing.xml:1617 #, no-c-format msgid "double-offset to get more curvy,combined with regular offset 15 to get parallel lines. Overlaid with original." msgstr "" #. Tag: programlisting -#: reference_processing.xml:1567 +#: reference_processing.xml:1620 #, no-c-format msgid "" "SELECT ST_AsText(ST_Collect(\n" @@ -2490,13 +2546,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1576 +#: reference_processing.xml:1629 #, no-c-format msgid "15, 'quad_segs=4 join=bevel' shown with original line" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1579 +#: reference_processing.xml:1632 #, no-c-format msgid "" "SELECT ST_AsText(ST_OffsetCurve(ST_GeomFromText(\n" @@ -2511,13 +2567,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1587 +#: reference_processing.xml:1640 #, no-c-format msgid "15,-15 collected, join=mitre mitre_limit=2.1" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1590 +#: reference_processing.xml:1643 #, no-c-format msgid "" "SELECT ST_AsText(ST_Collect(\n" @@ -2535,79 +2591,85 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:1607 +#: reference_processing.xml:1660 #, no-c-format msgid "ST_RemoveRepeatedPoints" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1608 +#: reference_processing.xml:1661 #, no-c-format msgid "Returns a version of the given geometry with duplicated points removed." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1614 +#: reference_processing.xml:1667 #, no-c-format -msgid "geometry ST_RemoveRepeatedPoints geometry geom" +msgid "geometry ST_RemoveRepeatedPoints geometry geom float8 tolerance" msgstr "" #. Tag: para -#: reference_processing.xml:1623 +#: reference_processing.xml:1677 #, no-c-format msgid "Returns a version of the given geometry with duplicated points removed. Will actually do something only with (multi)lines, (multi)polygons and multipoints but you can safely call it with any kind of geometry. Since simplification occurs on a object-by-object basis you can also feed a GeometryCollection to this function." msgstr "" +#. Tag: para +#: reference_processing.xml:1683 +#, 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: refname -#: reference_processing.xml:1643 +#: reference_processing.xml:1699 #, no-c-format msgid "ST_SharedPaths" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1644 +#: reference_processing.xml:1700 #, no-c-format msgid "Returns a collection containing paths shared by the two input linestrings/multilinestrings." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1649 +#: reference_processing.xml:1705 #, no-c-format msgid "geometry ST_SharedPaths geometry lineal1 geometry lineal2" msgstr "" #. Tag: para -#: reference_processing.xml:1659 +#: reference_processing.xml:1715 #, no-c-format msgid "Returns a collection containing paths shared by the two input geometries. Those going in the same direction are in the first element of the collection, those going in the opposite direction are in the second element. The paths themselves are given in the direction of the first geometry." msgstr "" #. Tag: para -#: reference_processing.xml:1664 +#: reference_processing.xml:1720 #, no-c-format msgid "Availability: 2.0.0 requires GEOS >= 3.3.0." msgstr "" #. Tag: title -#: reference_processing.xml:1667 +#: reference_processing.xml:1723 #, no-c-format msgid "Examples: Finding shared paths" msgstr "" #. Tag: para -#: reference_processing.xml:1677 +#: reference_processing.xml:1733 #, no-c-format msgid "A multilinestring and a linestring" msgstr "" #. Tag: para -#: reference_processing.xml:1688 +#: reference_processing.xml:1744 #, no-c-format msgid "The shared path of multilinestring and linestring overlaid with original geometries." msgstr "" #. Tag: programlisting -#: reference_processing.xml:1691 +#: reference_processing.xml:1747 #, no-c-format msgid "" "SELECT ST_AsText(\n" @@ -2625,7 +2687,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1697 +#: reference_processing.xml:1753 #, no-c-format msgid "" "-- same example but linestring orientation flipped\n" @@ -2644,66 +2706,72 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1707 +#: reference_processing.xml:1763 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_processing.xml:1717 +#: reference_processing.xml:1773 #, no-c-format -msgid "ST_Shift_Longitude" +msgid "ST_ShiftLongitude" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1719 +#: reference_processing.xml:1775 #, no-c-format msgid "Reads every point/vertex in every component of every feature in a geometry, and if the longitude coordinate is <0, adds 360 to it. The result would be a 0-360 version of the data to be plotted in a 180 centric map" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1727 +#: reference_processing.xml:1783 #, no-c-format -msgid "geometry ST_Shift_Longitude geometry geomA" +msgid "geometry ST_ShiftLongitude geometry geomA" msgstr "" #. Tag: para -#: reference_processing.xml:1737 +#: reference_processing.xml:1793 #, no-c-format msgid "Reads every point/vertex in every component of every feature in a geometry, and if the longitude coordinate is <0, adds 360 to it. The result would be a 0-360 version of the data to be plotted in a 180 centric map" msgstr "" #. Tag: para -#: reference_processing.xml:1741 +#: reference_processing.xml:1797 #, 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:1743 +#: reference_processing.xml:1799 #, no-c-format msgid "Pre-1.3.4 bug prevented this from working for MULTIPOINT. 1.3.4+ works with MULTIPOINT as well." msgstr "" #. Tag: para -#: reference_processing.xml:1748 +#: reference_processing.xml:1804 #, no-c-format msgid "Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced." msgstr "" +#. Tag: para +#: reference_processing.xml:1805 +#, no-c-format +msgid "NOTE: this function was renamed from \"ST_Shift_Longitude\" in 2.2.0" +msgstr "" + #. Tag: programlisting -#: reference_processing.xml:1757 +#: reference_processing.xml:1814 #, no-c-format msgid "" "--3d points\n" - "SELECT ST_AsEWKT(ST_Shift_Longitude(ST_GeomFromEWKT('SRID=4326;POINT(-118.58 38.38 10)'))) As geomA,\n" - " ST_AsEWKT(ST_Shift_Longitude(ST_GeomFromEWKT('SRID=4326;POINT(241.42 38.38 10)'))) As geomb\n" + "SELECT ST_AsEWKT(ST_ShiftLongitude(ST_GeomFromEWKT('SRID=4326;POINT(-118.58 38.38 10)'))) As geomA,\n" + " ST_AsEWKT(ST_ShiftLongitude(ST_GeomFromEWKT('SRID=4326;POINT(241.42 38.38 10)'))) As geomb\n" "geomA geomB\n" "---------- -----------\n" "SRID=4326;POINT(241.42 38.38 10) SRID=4326;POINT(-118.58 38.38 10)\n" "\n" "--regular line string\n" - "SELECT ST_AsText(ST_Shift_Longitude(ST_GeomFromText('LINESTRING(-118.58 38.38, -118.20 38.45)')))\n" + "SELECT ST_AsText(ST_ShiftLongitude(ST_GeomFromText('LINESTRING(-118.58 38.38, -118.20 38.45)')))\n" "\n" "st_astext\n" "----------\n" @@ -2711,61 +2779,61 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1763 +#: reference_processing.xml:1820 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_processing.xml:1769 +#: reference_processing.xml:1826 #, no-c-format msgid "ST_Simplify" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1770 +#: reference_processing.xml:1827 #, no-c-format msgid "Returns a \"simplified\" version of the given geometry using the Douglas-Peucker algorithm." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1776 +#: reference_processing.xml:1833 #, no-c-format msgid "geometry ST_Simplify geometry geomA float tolerance" msgstr "" #. Tag: para -#: reference_processing.xml:1786 +#: reference_processing.xml:1843 #, no-c-format msgid "Returns a \"simplified\" version of the given geometry using the Douglas-Peucker algorithm. Will actually do something only with (multi)lines and (multi)polygons but you can safely call it with any kind of geometry. Since simplification occurs on a object-by-object basis you can also feed a GeometryCollection to this function." msgstr "" #. Tag: para -#: reference_processing.xml:1793 +#: reference_processing.xml:1850 reference_processing.xml:1934 reference_processing.xml:1987 #, no-c-format msgid "Note that returned geometry might loose its simplicity (see )" msgstr "" #. Tag: para -#: reference_processing.xml:1795 +#: reference_processing.xml:1852 reference_processing.xml:1936 reference_processing.xml:1989 #, no-c-format msgid "Note topology may not be preserved and may result in invalid geometries. Use (see ) to preserve topology." msgstr "" #. Tag: para -#: reference_processing.xml:1797 +#: reference_processing.xml:1854 #, no-c-format msgid "Availability: 1.2.2" msgstr "" #. Tag: para -#: reference_processing.xml:1802 +#: reference_processing.xml:1859 #, no-c-format msgid "A circle simplified too much becomes a triangle, medium an octagon," msgstr "" #. Tag: programlisting -#: reference_processing.xml:1803 +#: reference_processing.xml:1860 #, no-c-format msgid "" "SELECT ST_Npoints(the_geom) As np_before, ST_NPoints(ST_Simplify(the_geom,0.1)) As np01_notbadcircle, ST_NPoints(ST_Simplify(the_geom,0.5)) As np05_notquitecircle,\n" @@ -2779,55 +2847,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1807 +#: reference_processing.xml:1864 #, no-c-format msgid ", , Topology " msgstr "" #. Tag: refname -#: reference_processing.xml:1813 +#: reference_processing.xml:1870 #, no-c-format msgid "ST_SimplifyPreserveTopology" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1814 +#: reference_processing.xml:1871 #, no-c-format msgid "Returns a \"simplified\" version of the given geometry using the Douglas-Peucker algorithm. Will avoid creating derived geometries (polygons in particular) that are invalid." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1821 +#: reference_processing.xml:1878 #, no-c-format msgid "geometry ST_SimplifyPreserveTopology geometry geomA float tolerance" msgstr "" #. Tag: para -#: reference_processing.xml:1831 +#: reference_processing.xml:1888 #, no-c-format msgid "Returns a \"simplified\" version of the given geometry using the Douglas-Peucker algorithm. Will avoid creating derived geometries (polygons in particular) that are invalid. Will actually do something only with (multi)lines and (multi)polygons but you can safely call it with any kind of geometry. Since simplification occurs on a object-by-object basis you can also feed a GeometryCollection to this function." msgstr "" #. Tag: para -#: reference_processing.xml:1840 +#: reference_processing.xml:1897 #, no-c-format msgid "Requires GEOS 3.0.0+" msgstr "" #. Tag: para -#: reference_processing.xml:1841 +#: reference_processing.xml:1898 #, no-c-format msgid "Availability: 1.3.3" msgstr "" #. Tag: para -#: reference_processing.xml:1846 +#: reference_processing.xml:1903 #, no-c-format msgid "Same example as Simplify, but we see Preserve Topology prevents oversimplification. The circle can at most become a square." msgstr "" #. Tag: programlisting -#: reference_processing.xml:1847 +#: reference_processing.xml:1904 #, no-c-format msgid "" "SELECT ST_Npoints(the_geom) As np_before, ST_NPoints(ST_SimplifyPreserveTopology(the_geom,0.1)) As np01_notbadcircle, ST_NPoints(ST_SimplifyPreserveTopology(the_geom,0.5)) As np05_notquitecircle,\n" @@ -2842,61 +2910,187 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:1857 +#: reference_processing.xml:1914 +#, no-c-format +msgid "ST_SimplifyVW" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1915 +#, no-c-format +msgid "Returns a \"simplified\" version of the given geometry using the Visvalingam-Whyatt algorithm" +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1920 +#, no-c-format +msgid "geometry ST_SimplifyVW geometry geomA float tolerance" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1930 +#, no-c-format +msgid "Returns a \"simplified\" version of the given geometry using the Visvalingam-Whyatt algorithm. Will actually do something only with (multi)lines and (multi)polygons but you can safely call it with any kind of geometry. Since simplification occurs on a object-by-object basis you can also feed a GeometryCollection to this function." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1937 +#, no-c-format +msgid "This function handles 3D and the third dimmension will affect the result" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1943 reference_processing.xml:1997 +#, no-c-format +msgid "A linestring that get the efffective area calculated. All points is returned since we give 0 as themin area threashold" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1944 +#, no-c-format +msgid "" + "select ST_AStext(ST_SimplifyVW(geom,30)) simplified\n" + "FROM (SELECT 'LINESTRING(5 2, 3 8, 6 20, 7 25, 10 10)'::geometry geom) As foo; \n" + "-result\n" + " simplified\n" + "-----------+-------------------+\n" + "LINESTRING(5 2,7 25,10 10)" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1948 +#, no-c-format +msgid ", , , Topology " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1953 +#, no-c-format +msgid "ST_SetEffectiveArea" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1954 +#, no-c-format +msgid "Sets for each vertex point it's effective area, and can by filtring on this area return a simplified geometry" +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1960 +#, no-c-format +msgid "geometry ST_SetEffectiveArea geometry geomA float threashold = 0 integer set_area = 1" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1971 +#, no-c-format +msgid "Sets for each vertex point it's effective area from Visvalingam-Whyatt’s algorithm. The effective area is stored as the M-value of the geomtries. If the second optional parameter is used, the resulting geometriy will be build only on vertex points with an effective area greater than or equal to that threashold value. That will be a simplified geometry." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1975 +#, no-c-format +msgid "This function can be used for server side simplification by using the threashold. Another option is to not give any threashold value. Then you get the full geometry back, but with effective areas as M-values wich can be used by the client to simplify very fast." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1978 +#, no-c-format +msgid "Will actually do something only with (multi)lines and (multi)polygons but you can safely call it with any kind of geometry. Since simplification occurs on a object-by-object basis you can also feed a GeometryCollection to this function." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1990 +#, no-c-format +msgid "The output geoemtry will loose all previous information in the M-values" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1991 +#, no-c-format +msgid "This function handles 3D and the third dimmension will affect the effective area" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1998 +#, no-c-format +msgid "" + "select ST_AStext(ST_SetEffectiveArea(geom)) all_pts, ST_AStext(ST_SetEffectiveArea(geom,30) ) thrshld_30\n" + "FROM (SELECT 'LINESTRING(5 2, 3 8, 6 20, 7 25, 10 10)'::geometry geom) As foo; \n" + "-result\n" + " all_pts | thrshld_30\n" + "-----------+-------------------+\n" + "LINESTRING M (5 2 3.40282346638529e+38,3 8 29,6 20 1.5,7 25 49.5,10 10 3.40282346638529e+38) | LINESTRING M (5 2 3.40282346638529e+38,7 25 49.5,10 10 3.40282346638529e+38)" +msgstr "" + +#. Tag: refname +#: reference_processing.xml:2008 #, no-c-format msgid "ST_Split" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1858 +#: reference_processing.xml:2009 #, no-c-format msgid "Returns a collection of geometries resulting by splitting a geometry." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1863 +#: reference_processing.xml:2014 #, no-c-format msgid "geometry ST_Split geometry input geometry blade" msgstr "" #. Tag: para -#: reference_processing.xml:1873 +#: reference_processing.xml:2024 #, no-c-format -msgid "The function supports splitting a line by point, a line by line, a polygon by line. The returned geometry is always a collection." +msgid "The function supports splitting a line by (multi)point, (multi)line or (multi)polygon boundary, a (multi)polygon by line. The returned geometry is always a collection." msgstr "" #. Tag: para -#: reference_processing.xml:1877 +#: reference_processing.xml:2028 #, no-c-format msgid "Think of this function as the opposite of ST_Union. Theoretically applying ST_Union to the elements of the returned collection should always yield the original geometry." msgstr "" #. Tag: para -#: reference_processing.xml:1884 +#: reference_processing.xml:2035 +#, no-c-format +msgid "Changed: 2.2.0 support for splitting a line by a multiline, a multipoint or (multi)polygon boundary was introduced." +msgstr "" + +#. Tag: para +#: reference_processing.xml:2037 #, no-c-format msgid "To improve the robustness of ST_Split it may be convenient to the input to the blade in advance using a very low tolerance. Otherwise the internally used coordinate grid may cause tolerance problems, where coordinates of input and blade do not fall onto each other and the input is not being split correctly (see #2192)." msgstr "" #. Tag: para -#: reference_processing.xml:1889 +#: reference_processing.xml:2039 +#, no-c-format +msgid "When a (multi)polygon is passed as as the blade, its linear component (the boundary) is used for cutting the input." +msgstr "" + +#. Tag: para +#: reference_processing.xml:2047 #, no-c-format msgid "Polygon Cut by Line" msgstr "" #. Tag: para -#: reference_processing.xml:1901 reference_processing.xml:1935 +#: reference_processing.xml:2059 reference_processing.xml:2093 #, no-c-format msgid "Before Split" msgstr "" #. Tag: para -#: reference_processing.xml:1913 reference_processing.xml:1947 +#: reference_processing.xml:2071 reference_processing.xml:2105 #, no-c-format msgid "After split" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1922 +#: reference_processing.xml:2080 #, no-c-format msgid "" "-- this creates a geometry collection consisting of the 2 halves of the polygon\n" @@ -2923,13 +3117,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1923 +#: reference_processing.xml:2081 #, no-c-format msgid "Multilinestring Cut by point" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1956 +#: reference_processing.xml:2114 #, no-c-format msgid "" "SELECT ST_AsText(ST_Split(mline, pt)) As wktcut\n" @@ -2948,55 +3142,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1960 +#: reference_processing.xml:2118 #, no-c-format -msgid ", , , , " +msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_processing.xml:1966 +#: reference_processing.xml:2131 #, no-c-format msgid "ST_SymDifference" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1968 +#: reference_processing.xml:2133 #, no-c-format msgid "Returns a geometry that represents the portions of A and B that do not intersect. It is called a symmetric difference because ST_SymDifference(A,B) = ST_SymDifference(B,A)." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1975 +#: reference_processing.xml:2140 #, no-c-format msgid "geometry ST_SymDifference geometry geomA geometry geomB" msgstr "" #. Tag: para -#: reference_processing.xml:1986 +#: reference_processing.xml:2151 #, no-c-format msgid "Returns a geometry that represents the portions of A and B that do not intersect. It is called a symmetric difference because ST_SymDifference(A,B) = ST_SymDifference(B,A). One can think of this as ST_Union(geomA,geomB) - ST_Intersection(A,B)." msgstr "" #. Tag: para -#: reference_processing.xml:1996 +#: reference_processing.xml:2161 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.21" msgstr "" #. Tag: para -#: reference_processing.xml:2016 +#: reference_processing.xml:2181 #, no-c-format msgid "The original linestrings shown together" msgstr "" #. Tag: para -#: reference_processing.xml:2028 +#: reference_processing.xml:2193 #, no-c-format msgid "The symmetric difference of the two linestrings" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2037 +#: reference_processing.xml:2202 #, no-c-format msgid "" "--Safe for 2d - symmetric difference of 2 linestrings\n" @@ -3013,7 +3207,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2039 +#: reference_processing.xml:2204 #, no-c-format msgid "" "--When used in 3d doesn't quite do the right thing\n" @@ -3026,85 +3220,194 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2046 +#: reference_processing.xml:2211 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_processing.xml:2053 +#: reference_processing.xml:2218 +#, no-c-format +msgid "ST_Subdivide" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:2219 +#, no-c-format +msgid "Returns a set of geometry where no geometry in the set has more than the specified number of vertices." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:2224 +#, no-c-format +msgid "setof geometry ST_Subdivide geometry geom integer max_vertices=256" +msgstr "" + +#. Tag: para +#: reference_processing.xml:2235 +#, no-c-format +msgid "Turns a single geometry into a set in which each element has fewer than the maximum allowed number of vertices. Useful for converting excessively large polygons and other objects into small portions that fit within the database page size. Uses the same envelope clipping as ST_ClipByBox2D does, recursively subdividing the input geometry until all portions have less than the maximum vertex count. Minimum vertice count allowed is 8 and if you try to specify lower than 8, it will throw an error." +msgstr "" + +#. Tag: para +#: reference_processing.xml:2244 +#, no-c-format +msgid "Clipping performed by the GEOS module." +msgstr "" + +#. Tag: para +#: reference_processing.xml:2247 +#, no-c-format +msgid "Availability: 2.2.0 requires GEOS >= 3.5.0." +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:2253 +#, no-c-format +msgid "" + "-- Create a new subdivided table suitable for joining to the original\n" + "CREATE TABLE subdivided_geoms AS\n" + "SELECT pkey, ST_Subdivide(geom) AS geom\n" + "FROM original_geoms;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:2264 +#, no-c-format +msgid "Subdivide max 10 vertices" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:2267 +#, no-c-format +msgid "" + "SELECT row_number() OVER() As rn, ST_AsText(geom) As wkt\n" + "FROM ( SELECT ST_SubDivide('POLYGON((132 10,119 23,85 35,68 29,66 28,49 42,32 56,22 64,32 110,40 119,36 150,\n" + "57 158,75 171,92 182,114 184,132 186,146 178,176 184,179 162,184 141,190 122,\n" + "190 100,185 79,186 56,186 52,178 34,168 18,147 13,132 10))'::geometry,10)) As f(geom);" +msgstr "" + +#. Tag: screen +#: reference_processing.xml:2268 +#, no-c-format +msgid "" + "rn | wkt\n" + "---+---------------------------------------------------------------------------\n" + " 1 | POLYGON((22 64,29.3913043478263 98.000000000001,106.000000000001 98.00000000001,\n" + " 106.000000000001 27.5882352941173,85 35,68 29,66 28,49 42,32 56,22 64))\n" + " 2 | POLYGON((29.3913043478263 98.000000000001,32 110,40 119,36 150,57 158,\n" + " 75 11,92 182,106.000000000001 183.272727272727,106.000000000001 98.000000000001,\n" + " 29.913043478263 98.000000000001))\n" + " 3 | POLYGON((106.000000000001 27.5882352941173,106.000000000001 98.00000000000,\n" + " 189.52380952381 98.000000000001,185 79,186 56,186 52,178 34,168 18,147 13,\n" + " 132 0,119 23,106.000000000001 27.5882352941173))\n" + " 4 | POLYGON((106.000000000001 98.000000000001,106.000000000001 183.27272727272,\n" + " 114 184,132 186,146 178,176 184,179 162,184 141,190 122,190 100,189.5238095238\n" + " 98.000000000001,106.000000000001 98.000000000001))" +msgstr "" + +#. Tag: para +#: reference_processing.xml:2277 +#, no-c-format +msgid "Useful in conjunction with ST_Segmentize to create additional vertices that can then be used for splitting" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:2280 +#, no-c-format +msgid "SELECT ST_AsText(ST_SubDivide(ST_Segmentize('LINESTRING(0 0, 100 100, 150 150)'::geometry,10),8));" +msgstr "" + +#. Tag: screen +#: reference_processing.xml:2281 +#, no-c-format +msgid "" + "LINESTRING(0 0,7.07106781186547 7.07106781186547,14.1421356237309 14.1421356237309,21.2132034355964 21.2132034355964,28.2842712474619 28.2842712474619,35.3553390593274 35.3553390593274,37.499999999998 37.499999999998)\n" + "LINESTRING(37.499999999998 37.499999999998,42.4264068711929 42.4264068711929,49.4974746830583 49.4974746830583,56.5685424949238 56.5685424949238,63.6396103067893 63.6396103067893,70.7106781186548 70.7106781186548,74.999999999998 74.999999999998)\n" + "LINESTRING(74.999999999998 74.999999999998,77.7817459305202 77.7817459305202,84.8528137423857 84.8528137423857,91.9238815542512 91.9238815542512,98.9949493661167 98.9949493661167,100 100,107.071067811865 107.071067811865,112.499999999998 112.499999999998)\n" + "LINESTRING(112.499999999998 112.499999999998,114.142135623731 114.142135623731,121.213203435596 121.213203435596,128.284271247462 128.284271247462,135.355339059327 135.355339059327,142.426406871193 142.426406871193,149.497474683058 149.497474683058,149.999999999998 149.999999999998)" +msgstr "" + +#. Tag: para +#: reference_processing.xml:2288 +#, no-c-format +msgid ", , , " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:2301 #, no-c-format msgid "ST_Union" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:2054 +#: reference_processing.xml:2302 #, no-c-format msgid "Returns a geometry that represents the point set union of the Geometries." msgstr "" #. Tag: funcsynopsis -#: reference_processing.xml:2059 +#: reference_processing.xml:2307 #, no-c-format msgid " geometry ST_Union geometry set g1field geometry ST_Union geometry g1 geometry g2 geometry ST_Union geometry[] g1_array " msgstr "" #. Tag: para -#: reference_processing.xml:2078 +#: reference_processing.xml:2326 #, no-c-format msgid "Output type can be a MULTI*, single geometry, or Geometry Collection. Comes in 2 variants. Variant 1 unions 2 geometries resulting in a new geometry with no intersecting regions. Variant 2 is an aggregate function that takes a set of geometries and unions them into a single ST_Geometry resulting in no intersecting regions." msgstr "" #. Tag: para -#: reference_processing.xml:2082 +#: reference_processing.xml:2330 #, no-c-format msgid "Aggregate version: This function returns a MULTI geometry or NON-MULTI geometry from a set of geometries. The ST_Union() function is an \"aggregate\" function in the terminology of PostgreSQL. That means that it operates on rows of data, in the same way the SUM() and AVG() functions do and like most aggregates, it also ignores NULL geometries." msgstr "" #. Tag: para -#: reference_processing.xml:2088 +#: reference_processing.xml:2336 #, no-c-format msgid "Non-Aggregate version: This function returns a geometry being a union of two input geometries. Output type can be a MULTI*, NON-MULTI or GEOMETRYCOLLECTION. If any are NULL, then NULL is returned." msgstr "" #. Tag: para -#: reference_processing.xml:2092 +#: reference_processing.xml:2340 #, no-c-format msgid "ST_Collect and ST_Union are often interchangeable. ST_Union is in general orders of magnitude slower than ST_Collect because it tries to dissolve boundaries and reorder geometries to ensure that a constructed Multi* doesn't have intersecting regions." msgstr "" #. Tag: para -#: reference_processing.xml:2098 +#: reference_processing.xml:2346 #, no-c-format msgid "NOTE: this function was formerly called GeomUnion(), which was renamed from \"Union\" because UNION is an SQL reserved word." msgstr "" #. Tag: para -#: reference_processing.xml:2101 +#: reference_processing.xml:2349 #, 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" msgstr "" #. Tag: para -#: reference_processing.xml:2107 +#: reference_processing.xml:2355 #, no-c-format msgid "Aggregate version is not explicitly defined in OGC SPEC." msgstr "" #. Tag: para -#: reference_processing.xml:2108 +#: reference_processing.xml:2356 #, 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:2114 +#: reference_processing.xml:2362 #, no-c-format msgid "Aggregate example" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2115 +#: reference_processing.xml:2363 #, no-c-format msgid "" "SELECT stusps,\n" @@ -3114,7 +3417,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2117 +#: reference_processing.xml:2365 #, no-c-format msgid "" "SELECT ST_AsText(ST_Union(ST_GeomFromText('POINT(1 2)'),\n" @@ -3174,37 +3477,133 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:2130 +#: reference_processing.xml:2378 +#, no-c-format +msgid "ST_ClusterWithin" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:2380 +#, 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." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:2385 +#, no-c-format +msgid "geometry[] ST_ClusterWithin geometry g float8 distance" +msgstr "" + +#. Tag: para +#: reference_processing.xml:2396 +#, 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." +msgstr "" + +#. Tag: para +#: reference_processing.xml:2398 reference_processing.xml:2430 +#, no-c-format +msgid "Availability: 2.2.0 - requires GEOS" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:2403 +#, 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: refname +#: reference_processing.xml:2411 +#, no-c-format +msgid "ST_ClusterIntersecting" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:2413 +#, no-c-format +msgid "Aggregate. Returns an array with the connected components of a set of geometries" +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:2418 +#, no-c-format +msgid "geometry[] ST_ClusterIntersecting geometry g" +msgstr "" + +#. Tag: para +#: reference_processing.xml:2428 +#, 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: programlisting +#: reference_processing.xml:2435 +#, 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: refname +#: reference_processing.xml:2442 #, no-c-format msgid "ST_UnaryUnion" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:2132 +#: reference_processing.xml:2444 #, no-c-format msgid "Like ST_Union, but working at the geometry component level." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:2137 +#: reference_processing.xml:2449 #, no-c-format msgid "geometry ST_UnaryUnion geometry geom" msgstr "" #. Tag: para -#: reference_processing.xml:2148 +#: reference_processing.xml:2460 #, no-c-format msgid "Unlike ST_Union, ST_UnaryUnion does dissolve boundaries between components of a multipolygon (invalid) and does perform union between the components of a geometrycollection. Each components of the input geometry is assumed to be valid, so you won't get a valid multipolygon out of a bow-tie polygon (invalid)." msgstr "" #. Tag: para -#: reference_processing.xml:2158 +#: reference_processing.xml:2470 #, no-c-format msgid "You may use this function to node a set of linestrings. You may mix ST_UnaryUnion with ST_Collect to fine-tune how many geometries at once you want to dissolve to be nice on both memory size and CPU time, finding the balance between ST_Union and ST_MemUnion." msgstr "" #. Tag: para -#: reference_processing.xml:2176 +#: reference_processing.xml:2488 #, no-c-format msgid ", , , " msgstr "" diff --git a/doc/po/templates/reference_raster.xml.pot b/doc/po/templates/reference_raster.xml.pot index 097c886ea..169c49333 100644 --- a/doc/po/templates/reference_raster.xml.pot +++ b/doc/po/templates/reference_raster.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -107,7 +107,7 @@ msgid "A spatial datatype with two fields - geom (holding a geometry object) and 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:1002 reference_raster.xml:1058 reference_raster.xml:1103 reference_raster.xml:1209 reference_raster.xml:1418 reference_raster.xml:1505 reference_raster.xml:1601 reference_raster.xml:1668 reference_raster.xml:1733 reference_raster.xml:1775 reference_raster.xml:1825 reference_raster.xml:1864 reference_raster.xml:1898 reference_raster.xml:1935 reference_raster.xml:1978 reference_raster.xml:2013 reference_raster.xml:2047 reference_raster.xml:2097 reference_raster.xml:2151 reference_raster.xml:2188 reference_raster.xml:2228 reference_raster.xml:2283 reference_raster.xml:2338 reference_raster.xml:2384 reference_raster.xml:2419 reference_raster.xml:2455 reference_raster.xml:2491 reference_raster.xml:2526 reference_raster.xml:2565 reference_raster.xml:2599 reference_raster.xml:2633 reference_raster.xml:2677 reference_raster.xml:2739 reference_raster.xml:2794 reference_raster.xml:2835 reference_raster.xml:2882 reference_raster.xml:2924 reference_raster.xml:2975 reference_raster.xml:3010 reference_raster.xml:3085 reference_raster.xml:3128 reference_raster.xml:3174 reference_raster.xml:3232 reference_raster.xml:3275 reference_raster.xml:3326 reference_raster.xml:3369 reference_raster.xml:3441 reference_raster.xml:3528 reference_raster.xml:3615 reference_raster.xml:3703 reference_raster.xml:3788 reference_raster.xml:3914 reference_raster.xml:4010 reference_raster.xml:4062 reference_raster.xml:4110 reference_raster.xml:4153 reference_raster.xml:4200 reference_raster.xml:4244 reference_raster.xml:4282 reference_raster.xml:4357 reference_raster.xml:4426 reference_raster.xml:4494 reference_raster.xml:4571 reference_raster.xml:4643 reference_raster.xml:4722 reference_raster.xml:4830 reference_raster.xml:4865 reference_raster.xml:4932 reference_raster.xml:4997 reference_raster.xml:5110 reference_raster.xml:5231 reference_raster.xml:5297 reference_raster.xml:5376 reference_raster.xml:5522 reference_raster.xml:5565 reference_raster.xml:5611 reference_raster.xml:5696 reference_raster.xml:5787 reference_raster.xml:5875 reference_raster.xml:5986 reference_raster.xml:6179 reference_raster.xml:6455 reference_raster.xml:6599 reference_raster.xml:6836 reference_raster.xml:7042 reference_raster.xml:7166 reference_raster.xml:7492 reference_raster.xml:7610 reference_raster.xml:7723 reference_raster.xml:7865 reference_raster.xml:7951 reference_raster.xml:8023 reference_raster.xml:8087 reference_raster.xml:8158 reference_raster.xml:8233 reference_raster.xml:8316 reference_raster.xml:8387 reference_raster.xml:8443 reference_raster.xml:8518 reference_raster.xml:8589 reference_raster.xml:8673 reference_raster.xml:8765 reference_raster.xml:8847 reference_raster.xml:8901 reference_raster.xml:8975 reference_raster.xml:9023 reference_raster.xml:9075 reference_raster.xml:9117 reference_raster.xml:9165 reference_raster.xml:9216 reference_raster.xml:9264 reference_raster.xml:9306 reference_raster.xml:9380 reference_raster.xml:9425 reference_raster.xml:9470 reference_raster.xml:9515 reference_raster.xml:9584 reference_raster.xml:9631 reference_raster.xml:9704 reference_raster.xml:9772 reference_raster.xml:9861 reference_raster.xml:9946 reference_raster.xml:10027 reference_raster.xml:10108 reference_raster.xml:10237 reference_raster.xml:10321 reference_raster.xml:10401 reference_raster.xml:10520 reference_raster.xml:10567 reference_raster.xml:10639 reference_raster.xml:10736 reference_raster.xml:10829 +#: 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:1002 reference_raster.xml:1060 reference_raster.xml:1105 reference_raster.xml:1211 reference_raster.xml:1420 reference_raster.xml:1507 reference_raster.xml:1603 reference_raster.xml:1670 reference_raster.xml:1735 reference_raster.xml:1777 reference_raster.xml:1827 reference_raster.xml:1866 reference_raster.xml:1900 reference_raster.xml:1937 reference_raster.xml:1980 reference_raster.xml:2015 reference_raster.xml:2049 reference_raster.xml:2099 reference_raster.xml:2153 reference_raster.xml:2190 reference_raster.xml:2230 reference_raster.xml:2285 reference_raster.xml:2340 reference_raster.xml:2386 reference_raster.xml:2421 reference_raster.xml:2457 reference_raster.xml:2493 reference_raster.xml:2528 reference_raster.xml:2567 reference_raster.xml:2601 reference_raster.xml:2635 reference_raster.xml:2679 reference_raster.xml:2741 reference_raster.xml:2796 reference_raster.xml:2837 reference_raster.xml:2884 reference_raster.xml:2926 reference_raster.xml:2977 reference_raster.xml:3012 reference_raster.xml:3087 reference_raster.xml:3130 reference_raster.xml:3176 reference_raster.xml:3234 reference_raster.xml:3277 reference_raster.xml:3328 reference_raster.xml:3371 reference_raster.xml:3443 reference_raster.xml:3530 reference_raster.xml:3617 reference_raster.xml:3705 reference_raster.xml:3790 reference_raster.xml:3916 reference_raster.xml:4013 reference_raster.xml:4065 reference_raster.xml:4113 reference_raster.xml:4156 reference_raster.xml:4203 reference_raster.xml:4247 reference_raster.xml:4285 reference_raster.xml:4360 reference_raster.xml:4429 reference_raster.xml:4497 reference_raster.xml:4574 reference_raster.xml:4646 reference_raster.xml:4725 reference_raster.xml:4833 reference_raster.xml:4868 reference_raster.xml:4935 reference_raster.xml:5000 reference_raster.xml:5113 reference_raster.xml:5234 reference_raster.xml:5300 reference_raster.xml:5379 reference_raster.xml:5525 reference_raster.xml:5568 reference_raster.xml:5614 reference_raster.xml:5699 reference_raster.xml:5790 reference_raster.xml:5878 reference_raster.xml:5989 reference_raster.xml:6182 reference_raster.xml:6458 reference_raster.xml:6602 reference_raster.xml:6839 reference_raster.xml:7045 reference_raster.xml:7169 reference_raster.xml:7495 reference_raster.xml:7613 reference_raster.xml:7726 reference_raster.xml:7868 reference_raster.xml:7954 reference_raster.xml:8026 reference_raster.xml:8090 reference_raster.xml:8161 reference_raster.xml:8236 reference_raster.xml:8319 reference_raster.xml:8390 reference_raster.xml:8446 reference_raster.xml:8521 reference_raster.xml:8592 reference_raster.xml:8676 reference_raster.xml:8768 reference_raster.xml:8850 reference_raster.xml:8904 reference_raster.xml:8978 reference_raster.xml:9026 reference_raster.xml:9078 reference_raster.xml:9120 reference_raster.xml:9168 reference_raster.xml:9219 reference_raster.xml:9267 reference_raster.xml:9309 reference_raster.xml:9383 reference_raster.xml:9428 reference_raster.xml:9473 reference_raster.xml:9518 reference_raster.xml:9587 reference_raster.xml:9634 reference_raster.xml:9707 reference_raster.xml:9775 reference_raster.xml:9864 reference_raster.xml:9949 reference_raster.xml:10030 reference_raster.xml:10111 reference_raster.xml:10240 reference_raster.xml:10324 reference_raster.xml:10404 reference_raster.xml:10523 reference_raster.xml:10570 reference_raster.xml:10642 reference_raster.xml:10739 reference_raster.xml:10832 #, no-c-format msgid "Description" msgstr "" @@ -119,7 +119,7 @@ msgid "geomval is a compound data type consisting of a geometry object reference 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:1022 reference_raster.xml:1073 reference_raster.xml:1123 reference_raster.xml:1253 reference_raster.xml:1470 reference_raster.xml:1560 reference_raster.xml:1621 reference_raster.xml:1697 reference_raster.xml:1748 reference_raster.xml:1796 reference_raster.xml:1843 reference_raster.xml:1877 reference_raster.xml:1913 reference_raster.xml:1956 reference_raster.xml:1992 reference_raster.xml:2026 reference_raster.xml:2070 reference_raster.xml:2130 reference_raster.xml:2167 reference_raster.xml:2205 reference_raster.xml:2250 reference_raster.xml:2309 reference_raster.xml:2363 reference_raster.xml:2398 reference_raster.xml:2434 reference_raster.xml:2470 reference_raster.xml:2505 reference_raster.xml:2539 reference_raster.xml:2578 reference_raster.xml:2612 reference_raster.xml:2647 reference_raster.xml:2697 reference_raster.xml:2754 reference_raster.xml:2809 reference_raster.xml:2860 reference_raster.xml:2895 reference_raster.xml:2950 reference_raster.xml:2988 reference_raster.xml:3063 reference_raster.xml:3100 reference_raster.xml:3142 reference_raster.xml:3200 reference_raster.xml:3243 reference_raster.xml:3294 reference_raster.xml:3337 reference_raster.xml:3388 reference_raster.xml:3463 reference_raster.xml:3553 reference_raster.xml:3647 reference_raster.xml:3718 reference_raster.xml:3867 reference_raster.xml:3932 reference_raster.xml:4088 reference_raster.xml:4123 reference_raster.xml:4172 reference_raster.xml:4217 reference_raster.xml:4257 reference_raster.xml:4295 reference_raster.xml:4387 reference_raster.xml:4452 reference_raster.xml:4521 reference_raster.xml:4599 reference_raster.xml:4673 reference_raster.xml:4795 reference_raster.xml:4843 reference_raster.xml:4884 reference_raster.xml:4953 reference_raster.xml:5014 reference_raster.xml:5145 reference_raster.xml:5246 reference_raster.xml:5333 reference_raster.xml:5393 reference_raster.xml:5540 reference_raster.xml:5650 reference_raster.xml:5741 reference_raster.xml:5832 reference_raster.xml:5912 reference_raster.xml:6142 reference_raster.xml:6376 reference_raster.xml:6520 reference_raster.xml:6767 reference_raster.xml:7003 reference_raster.xml:7116 reference_raster.xml:7408 reference_raster.xml:7567 reference_raster.xml:7690 reference_raster.xml:7823 reference_raster.xml:7894 reference_raster.xml:7982 reference_raster.xml:8055 reference_raster.xml:8125 reference_raster.xml:8194 reference_raster.xml:8276 reference_raster.xml:8355 reference_raster.xml:8410 reference_raster.xml:8479 reference_raster.xml:8550 reference_raster.xml:8625 reference_raster.xml:8718 reference_raster.xml:8815 reference_raster.xml:8858 reference_raster.xml:8943 reference_raster.xml:8991 reference_raster.xml:9042 reference_raster.xml:9092 reference_raster.xml:9137 reference_raster.xml:9190 reference_raster.xml:9236 reference_raster.xml:9279 reference_raster.xml:9318 reference_raster.xml:9529 reference_raster.xml:9597 reference_raster.xml:9650 reference_raster.xml:9716 reference_raster.xml:9807 reference_raster.xml:9892 reference_raster.xml:9973 reference_raster.xml:10054 reference_raster.xml:10138 reference_raster.xml:10267 reference_raster.xml:10348 reference_raster.xml:10428 reference_raster.xml:10541 reference_raster.xml:10585 reference_raster.xml:10672 reference_raster.xml:10767 reference_raster.xml:10860 +#: 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:1024 reference_raster.xml:1075 reference_raster.xml:1125 reference_raster.xml:1255 reference_raster.xml:1472 reference_raster.xml:1562 reference_raster.xml:1623 reference_raster.xml:1699 reference_raster.xml:1750 reference_raster.xml:1798 reference_raster.xml:1845 reference_raster.xml:1879 reference_raster.xml:1915 reference_raster.xml:1958 reference_raster.xml:1994 reference_raster.xml:2028 reference_raster.xml:2072 reference_raster.xml:2132 reference_raster.xml:2169 reference_raster.xml:2207 reference_raster.xml:2252 reference_raster.xml:2311 reference_raster.xml:2365 reference_raster.xml:2400 reference_raster.xml:2436 reference_raster.xml:2472 reference_raster.xml:2507 reference_raster.xml:2541 reference_raster.xml:2580 reference_raster.xml:2614 reference_raster.xml:2649 reference_raster.xml:2699 reference_raster.xml:2756 reference_raster.xml:2811 reference_raster.xml:2862 reference_raster.xml:2897 reference_raster.xml:2952 reference_raster.xml:2990 reference_raster.xml:3065 reference_raster.xml:3102 reference_raster.xml:3144 reference_raster.xml:3202 reference_raster.xml:3245 reference_raster.xml:3296 reference_raster.xml:3339 reference_raster.xml:3390 reference_raster.xml:3465 reference_raster.xml:3555 reference_raster.xml:3649 reference_raster.xml:3720 reference_raster.xml:3869 reference_raster.xml:3935 reference_raster.xml:4091 reference_raster.xml:4126 reference_raster.xml:4175 reference_raster.xml:4220 reference_raster.xml:4260 reference_raster.xml:4298 reference_raster.xml:4390 reference_raster.xml:4455 reference_raster.xml:4524 reference_raster.xml:4602 reference_raster.xml:4676 reference_raster.xml:4798 reference_raster.xml:4846 reference_raster.xml:4887 reference_raster.xml:4956 reference_raster.xml:5017 reference_raster.xml:5148 reference_raster.xml:5249 reference_raster.xml:5336 reference_raster.xml:5396 reference_raster.xml:5543 reference_raster.xml:5653 reference_raster.xml:5744 reference_raster.xml:5835 reference_raster.xml:5915 reference_raster.xml:6145 reference_raster.xml:6379 reference_raster.xml:6523 reference_raster.xml:6770 reference_raster.xml:7006 reference_raster.xml:7119 reference_raster.xml:7411 reference_raster.xml:7570 reference_raster.xml:7693 reference_raster.xml:7826 reference_raster.xml:7897 reference_raster.xml:7985 reference_raster.xml:8058 reference_raster.xml:8128 reference_raster.xml:8197 reference_raster.xml:8279 reference_raster.xml:8358 reference_raster.xml:8413 reference_raster.xml:8482 reference_raster.xml:8553 reference_raster.xml:8628 reference_raster.xml:8721 reference_raster.xml:8818 reference_raster.xml:8861 reference_raster.xml:8946 reference_raster.xml:8994 reference_raster.xml:9045 reference_raster.xml:9095 reference_raster.xml:9140 reference_raster.xml:9193 reference_raster.xml:9239 reference_raster.xml:9282 reference_raster.xml:9321 reference_raster.xml:9532 reference_raster.xml:9600 reference_raster.xml:9653 reference_raster.xml:9719 reference_raster.xml:9810 reference_raster.xml:9895 reference_raster.xml:9976 reference_raster.xml:10057 reference_raster.xml:10141 reference_raster.xml:10270 reference_raster.xml:10351 reference_raster.xml:10431 reference_raster.xml:10544 reference_raster.xml:10588 reference_raster.xml:10675 reference_raster.xml:10770 reference_raster.xml:10863 #, no-c-format msgid "See Also" msgstr "" @@ -648,7 +648,7 @@ msgid "If you need to load more data in your tables after you have already appli msgstr "" #. Tag: para -#: reference_raster.xml:568 reference_raster.xml:717 reference_raster.xml:793 reference_raster.xml:859 reference_raster.xml:1511 reference_raster.xml:1902 reference_raster.xml:2932 reference_raster.xml:3089 reference_raster.xml:3132 reference_raster.xml:3189 reference_raster.xml:4873 reference_raster.xml:4936 reference_raster.xml:5131 reference_raster.xml:5235 reference_raster.xml:5305 reference_raster.xml:5527 reference_raster.xml:6000 reference_raster.xml:7062 reference_raster.xml:7261 reference_raster.xml:7525 reference_raster.xml:7644 reference_raster.xml:7773 reference_raster.xml:7871 reference_raster.xml:7959 reference_raster.xml:8043 reference_raster.xml:8182 reference_raster.xml:8257 reference_raster.xml:8344 reference_raster.xml:8467 reference_raster.xml:8538 reference_raster.xml:8613 reference_raster.xml:8699 reference_raster.xml:8795 reference_raster.xml:8923 reference_raster.xml:9387 reference_raster.xml:9639 reference_raster.xml:9711 reference_raster.xml:10530 +#: reference_raster.xml:568 reference_raster.xml:717 reference_raster.xml:793 reference_raster.xml:859 reference_raster.xml:1513 reference_raster.xml:1904 reference_raster.xml:2934 reference_raster.xml:3091 reference_raster.xml:3134 reference_raster.xml:3191 reference_raster.xml:4876 reference_raster.xml:4939 reference_raster.xml:5134 reference_raster.xml:5238 reference_raster.xml:5308 reference_raster.xml:5530 reference_raster.xml:6003 reference_raster.xml:7065 reference_raster.xml:7264 reference_raster.xml:7528 reference_raster.xml:7647 reference_raster.xml:7776 reference_raster.xml:7874 reference_raster.xml:7962 reference_raster.xml:8046 reference_raster.xml:8185 reference_raster.xml:8260 reference_raster.xml:8347 reference_raster.xml:8470 reference_raster.xml:8541 reference_raster.xml:8616 reference_raster.xml:8702 reference_raster.xml:8798 reference_raster.xml:8926 reference_raster.xml:9390 reference_raster.xml:9642 reference_raster.xml:9714 reference_raster.xml:10533 #, no-c-format msgid "Availability: 2.0.0" msgstr "" @@ -762,7 +762,7 @@ msgid "the table will disappear from the raster_columns catal 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:1515 reference_raster.xml:1614 reference_raster.xml:1688 reference_raster.xml:1789 reference_raster.xml:1837 reference_raster.xml:1870 reference_raster.xml:1906 reference_raster.xml:1949 reference_raster.xml:1985 reference_raster.xml:2019 reference_raster.xml:2159 reference_raster.xml:2197 reference_raster.xml:2240 reference_raster.xml:2299 reference_raster.xml:2353 reference_raster.xml:2391 reference_raster.xml:2426 reference_raster.xml:2462 reference_raster.xml:2498 reference_raster.xml:2534 reference_raster.xml:2571 reference_raster.xml:2605 reference_raster.xml:2639 reference_raster.xml:2690 reference_raster.xml:2747 reference_raster.xml:2802 reference_raster.xml:2853 reference_raster.xml:2888 reference_raster.xml:2943 reference_raster.xml:2981 reference_raster.xml:3056 reference_raster.xml:3093 reference_raster.xml:3137 reference_raster.xml:3195 reference_raster.xml:3238 reference_raster.xml:3289 reference_raster.xml:3332 reference_raster.xml:3383 reference_raster.xml:3450 reference_raster.xml:3544 reference_raster.xml:3636 reference_raster.xml:3711 reference_raster.xml:3924 reference_raster.xml:4019 reference_raster.xml:4082 reference_raster.xml:4116 reference_raster.xml:4164 reference_raster.xml:4207 reference_raster.xml:4288 reference_raster.xml:4381 reference_raster.xml:4445 reference_raster.xml:4513 reference_raster.xml:4591 reference_raster.xml:4668 reference_raster.xml:4747 reference_raster.xml:4836 reference_raster.xml:4877 reference_raster.xml:4947 reference_raster.xml:5009 reference_raster.xml:5239 reference_raster.xml:5388 reference_raster.xml:5531 reference_raster.xml:5584 reference_raster.xml:5824 reference_raster.xml:6265 reference_raster.xml:7066 reference_raster.xml:7529 reference_raster.xml:7777 reference_raster.xml:8048 reference_raster.xml:8120 reference_raster.xml:8187 reference_raster.xml:8349 reference_raster.xml:8405 reference_raster.xml:8472 reference_raster.xml:8543 reference_raster.xml:8618 reference_raster.xml:8853 reference_raster.xml:8986 reference_raster.xml:9037 reference_raster.xml:9086 reference_raster.xml:9129 reference_raster.xml:9185 reference_raster.xml:9230 reference_raster.xml:9274 reference_raster.xml:9313 reference_raster.xml:9391 reference_raster.xml:9436 reference_raster.xml:9481 reference_raster.xml:9644 reference_raster.xml:9800 reference_raster.xml:9887 reference_raster.xml:9968 reference_raster.xml:10049 reference_raster.xml:10130 reference_raster.xml:10262 reference_raster.xml:10343 reference_raster.xml:10423 reference_raster.xml:10580 reference_raster.xml:10667 reference_raster.xml:10762 reference_raster.xml:10855 +#: reference_raster.xml:720 reference_raster.xml:797 reference_raster.xml:894 reference_raster.xml:930 reference_raster.xml:968 reference_raster.xml:1517 reference_raster.xml:1616 reference_raster.xml:1690 reference_raster.xml:1791 reference_raster.xml:1839 reference_raster.xml:1872 reference_raster.xml:1908 reference_raster.xml:1951 reference_raster.xml:1987 reference_raster.xml:2021 reference_raster.xml:2161 reference_raster.xml:2199 reference_raster.xml:2242 reference_raster.xml:2301 reference_raster.xml:2355 reference_raster.xml:2393 reference_raster.xml:2428 reference_raster.xml:2464 reference_raster.xml:2500 reference_raster.xml:2536 reference_raster.xml:2573 reference_raster.xml:2607 reference_raster.xml:2641 reference_raster.xml:2692 reference_raster.xml:2749 reference_raster.xml:2804 reference_raster.xml:2855 reference_raster.xml:2890 reference_raster.xml:2945 reference_raster.xml:2983 reference_raster.xml:3058 reference_raster.xml:3095 reference_raster.xml:3139 reference_raster.xml:3197 reference_raster.xml:3240 reference_raster.xml:3291 reference_raster.xml:3334 reference_raster.xml:3385 reference_raster.xml:3452 reference_raster.xml:3546 reference_raster.xml:3638 reference_raster.xml:3713 reference_raster.xml:3926 reference_raster.xml:4022 reference_raster.xml:4085 reference_raster.xml:4119 reference_raster.xml:4167 reference_raster.xml:4210 reference_raster.xml:4291 reference_raster.xml:4384 reference_raster.xml:4448 reference_raster.xml:4516 reference_raster.xml:4594 reference_raster.xml:4671 reference_raster.xml:4750 reference_raster.xml:4839 reference_raster.xml:4880 reference_raster.xml:4950 reference_raster.xml:5012 reference_raster.xml:5242 reference_raster.xml:5391 reference_raster.xml:5534 reference_raster.xml:5587 reference_raster.xml:5827 reference_raster.xml:6268 reference_raster.xml:7069 reference_raster.xml:7532 reference_raster.xml:7780 reference_raster.xml:8051 reference_raster.xml:8123 reference_raster.xml:8190 reference_raster.xml:8352 reference_raster.xml:8408 reference_raster.xml:8475 reference_raster.xml:8546 reference_raster.xml:8621 reference_raster.xml:8856 reference_raster.xml:8989 reference_raster.xml:9040 reference_raster.xml:9089 reference_raster.xml:9132 reference_raster.xml:9188 reference_raster.xml:9233 reference_raster.xml:9277 reference_raster.xml:9316 reference_raster.xml:9394 reference_raster.xml:9439 reference_raster.xml:9484 reference_raster.xml:9647 reference_raster.xml:9803 reference_raster.xml:9890 reference_raster.xml:9971 reference_raster.xml:10052 reference_raster.xml:10133 reference_raster.xml:10265 reference_raster.xml:10346 reference_raster.xml:10426 reference_raster.xml:10583 reference_raster.xml:10670 reference_raster.xml:10765 reference_raster.xml:10858 #, no-c-format msgid "Examples" msgstr "" @@ -1019,58 +1019,75 @@ msgid "Returns a list of raster formats short_name,long_name and creator options msgstr "" #. Tag: para -#: reference_raster.xml:1007 reference_raster.xml:1438 reference_raster.xml:5631 reference_raster.xml:5729 reference_raster.xml:5820 reference_raster.xml:5900 +#: reference_raster.xml:1007 +#, no-c-format +msgid "Changed: 2.0.6, 2.1.3 - by default no drivers are enabled, unless GUC or Environment variable gdal_enabled_drivers is set." +msgstr "" + +#. Tag: para +#: reference_raster.xml:1008 reference_raster.xml:1440 reference_raster.xml:5634 reference_raster.xml:5732 reference_raster.xml:5823 reference_raster.xml:5903 #, no-c-format msgid "Availability: 2.0.0 - requires GDAL >= 1.6.0." msgstr "" #. Tag: title -#: reference_raster.xml:1011 +#: reference_raster.xml:1013 #, no-c-format msgid "Examples: List of Drivers" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1013 +#: reference_raster.xml:1015 #, no-c-format msgid "" + "SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';\n" "SELECT short_name, long_name\n" "FROM st_gdaldrivers()\n" "ORDER BY short_name;\n" - " short_name | long_name\n" - "----------------+--------------------------------------\n" - "AAIGrid | Arc/Info ASCII Grid\n" - "DTED | DTED Elevation Raster\n" - "EHdr | ESRI .hdr Labelled\n" - "FIT | FIT Image\n" - "GIF | Graphics Interchange Format (.gif)\n" - "GSAG | Golden Software ASCII Grid (.grd)\n" - "GSBG | Golden Software Binary Grid (.grd)\n" - "GTiff | GeoTIFF\n" - "HF2 | HF2/HFZ heightfield raster\n" - "HFA | Erdas Imagine Images (.img)\n" - "ILWIS | ILWIS Raster Map\n" - "INGR | Intergraph Raster\n" - "JPEG | JPEG JFIF\n" - "KMLSUPEROVERLAY | Kml Super Overlay\n" - "NITF | National Imagery Transmission Format\n" - "PNG | Portable Network Graphics\n" - "R | R Object Data Store\n" - "SAGA | SAGA GIS Binary Grid (.sdat)\n" - "SRTMHGT | SRTMHGT File Format\n" - "USGSDEM | USGS Optional ASCII DEM (and CDED)\n" - "VRT | Virtual Raster\n" - "XPM | X11 PixMap Format" + " short_name | long_name\n" + "-----------------+--------------------------------------\n" + " AAIGrid | Arc/Info ASCII Grid\n" + " ARG | Azavea Raster Grid format\n" + " DTED | DTED Elevation Raster\n" + " EHdr | ESRI .hdr Labelled\n" + " FIT | FIT Image\n" + " GIF | Graphics Interchange Format (.gif)\n" + " GPKG | GeoPackage\n" + " GS7BG | Golden Software 7 Binary Grid (.grd)\n" + " GSAG | Golden Software ASCII Grid (.grd)\n" + " GSBG | Golden Software Binary Grid (.grd)\n" + " GTiff | GeoTIFF\n" + " HF2 | HF2/HFZ heightfield raster\n" + " HFA | Erdas Imagine Images (.img)\n" + " ILWIS | ILWIS Raster Map\n" + " INGR | Intergraph Raster\n" + " JPEG | JPEG JFIF\n" + " KMLSUPEROVERLAY | Kml Super Overlay\n" + " LCP | FARSITE v.4 Landscape File (.lcp)\n" + " MFF | Vexcel MFF Raster\n" + " NITF | National Imagery Transmission Format\n" + " PNG | Portable Network Graphics\n" + " R | R Object Data Store\n" + " RST | Idrisi Raster A.1\n" + " SAGA | SAGA GIS Binary Grid (.sdat)\n" + " SRTMHGT | SRTMHGT File Format\n" + " USGSDEM | USGS Optional ASCII DEM (and CDED)\n" + " VRT | Virtual Raster\n" + " WMS | OGC Web Map Service\n" + " XPM | X11 PixMap Format\n" + " XYZ | ASCII Gridded XYZ\n" + " ZMap | ZMap Plus Grid\n" + "(31 rows)" msgstr "" #. Tag: title -#: reference_raster.xml:1015 +#: reference_raster.xml:1017 #, no-c-format msgid "Example: List of options for each driver" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1016 +#: reference_raster.xml:1018 #, no-c-format msgid "" "-- Output the create options XML column of JPEG as a table --\n" @@ -1082,15 +1099,23 @@ msgid "" "FROM st_gdaldrivers()\n" "WHERE short_name = 'JPEG') As g;\n" "\n" - " oname | otype | descrip\n" - "-------------+---------+-----------------------------\n" - " PROGRESSIVE | boolean |\n" - " QUALITY | int | good=100, bad=0, default=75\n" - " WORLDFILE | boolean |" + " oname | otype | descrip\n" + "--------------------+---------+-------------------------------------------------\n" + " PROGRESSIVE | boolean | whether to generate a progressive JPEG\n" + " QUALITY | int | good=100, bad=0, default=75\n" + " WORLDFILE | boolean | whether to geneate a worldfile\n" + " INTERNAL_MASK | boolean | whether to generate a validity mask\n" + " COMMENT | string | Comment\n" + " SOURCE_ICC_PROFILE | string | ICC profile encoded in Base64\n" + " EXIF_THUMBNAIL | boolean | whether to generate an EXIF thumbnail(overview).\n" + " By default its max dimension will be 128\n" + " THUMBNAIL_WIDTH | int | Forced thumbnail width\n" + " THUMBNAIL_HEIGHT | int | Forced thumbnail height\n" + "(9 rows)" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1018 +#: reference_raster.xml:1020 #, no-c-format msgid "" "-- raw xml output for creator options for GeoTiff --\n" @@ -1193,163 +1218,163 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1024 reference_raster.xml:2506 +#: reference_raster.xml:1026 #, no-c-format -msgid ", " +msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:1030 +#: reference_raster.xml:1032 #, no-c-format msgid "UpdateRasterSRID" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1031 +#: reference_raster.xml:1033 #, no-c-format msgid "Change the SRID of all rasters in the user-specified column and table." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:1037 +#: reference_raster.xml:1039 #, no-c-format msgid " raster UpdateRasterSRID name schema_name name table_name name column_name integer new_srid raster UpdateRasterSRID name table_name name column_name integer new_srid " msgstr "" #. Tag: para -#: reference_raster.xml:1060 +#: reference_raster.xml:1062 #, no-c-format msgid "Change the SRID of all rasters in the user-specified column and table. The function will drop all appropriate column constraints (extent, alignment and SRID) before changing the SRID of the specified column's rasters." msgstr "" #. Tag: para -#: reference_raster.xml:1065 +#: reference_raster.xml:1067 #, no-c-format msgid "The data (band pixel values) of the rasters are not touched by this function. Only the raster's metadata is changed." msgstr "" #. Tag: para -#: reference_raster.xml:1070 reference_raster.xml:1684 reference_raster.xml:1785 reference_raster.xml:2235 reference_raster.xml:2530 reference_raster.xml:2685 reference_raster.xml:3234 reference_raster.xml:3284 reference_raster.xml:3328 reference_raster.xml:3378 reference_raster.xml:3535 reference_raster.xml:3632 reference_raster.xml:3817 reference_raster.xml:3920 reference_raster.xml:4016 reference_raster.xml:6261 reference_raster.xml:6725 reference_raster.xml:6842 reference_raster.xml:8116 reference_raster.xml:8401 reference_raster.xml:8849 reference_raster.xml:8982 reference_raster.xml:9033 reference_raster.xml:9270 reference_raster.xml:9524 reference_raster.xml:9796 reference_raster.xml:9883 reference_raster.xml:9964 reference_raster.xml:10045 reference_raster.xml:10126 reference_raster.xml:10339 reference_raster.xml:10419 reference_raster.xml:10576 reference_raster.xml:10663 reference_raster.xml:10758 reference_raster.xml:10851 +#: reference_raster.xml:1072 reference_raster.xml:1686 reference_raster.xml:1787 reference_raster.xml:2237 reference_raster.xml:2532 reference_raster.xml:2687 reference_raster.xml:3236 reference_raster.xml:3286 reference_raster.xml:3330 reference_raster.xml:3380 reference_raster.xml:3537 reference_raster.xml:3634 reference_raster.xml:3819 reference_raster.xml:3922 reference_raster.xml:4019 reference_raster.xml:6264 reference_raster.xml:6728 reference_raster.xml:6845 reference_raster.xml:8119 reference_raster.xml:8404 reference_raster.xml:8852 reference_raster.xml:8985 reference_raster.xml:9036 reference_raster.xml:9273 reference_raster.xml:9527 reference_raster.xml:9799 reference_raster.xml:9886 reference_raster.xml:9967 reference_raster.xml:10048 reference_raster.xml:10129 reference_raster.xml:10342 reference_raster.xml:10422 reference_raster.xml:10579 reference_raster.xml:10666 reference_raster.xml:10761 reference_raster.xml:10854 #, no-c-format msgid "Availability: 2.1.0" msgstr "" #. Tag: refname -#: reference_raster.xml:1082 +#: reference_raster.xml:1084 #, no-c-format msgid "ST_CreateOverview" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1083 +#: reference_raster.xml:1085 #, no-c-format msgid "Create an reduced resolution version of a given raster coverage." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:1091 +#: reference_raster.xml:1093 #, no-c-format msgid "regclass ST_CreateOverview regclass tab name col int factor text algo='NearestNeighbor'" msgstr "" #. Tag: para -#: reference_raster.xml:1105 +#: reference_raster.xml:1107 #, no-c-format msgid "Create an overview table with resampled tiles from the source table. Output tiles will have the same size of input tiles and cover the same spatial extent with a lower resolution (pixel size will be 1/factor of the original in both directions)." msgstr "" #. Tag: para -#: reference_raster.xml:1112 +#: reference_raster.xml:1114 #, no-c-format msgid "The overview table will be made available in the raster_overviews catalog and will have raster constraints enforced." msgstr "" #. Tag: para -#: reference_raster.xml:1118 reference_raster.xml:1743 reference_raster.xml:4726 +#: reference_raster.xml:1120 reference_raster.xml:1745 reference_raster.xml:4729 #, no-c-format msgid "Algorithm options are: 'NearestNeighbor', 'Bilinear', 'Cubic', 'CubicSpline', and 'Lanczos'. Refer to: GDAL Warp resampling methods for more details." msgstr "" #. Tag: para -#: reference_raster.xml:1120 reference_raster.xml:1745 reference_raster.xml:1944 reference_raster.xml:5005 reference_raster.xml:5384 +#: reference_raster.xml:1122 reference_raster.xml:1747 reference_raster.xml:1946 reference_raster.xml:5008 reference_raster.xml:5387 #, no-c-format msgid "Availability: 2.2.0" msgstr "" #. Tag: para -#: reference_raster.xml:1124 +#: reference_raster.xml:1126 #, no-c-format msgid ", , , " msgstr "" #. Tag: title -#: reference_raster.xml:1135 +#: reference_raster.xml:1137 #, no-c-format msgid "Raster Constructors" msgstr "" #. Tag: refname -#: reference_raster.xml:1139 +#: reference_raster.xml:1141 #, no-c-format msgid "ST_AddBand" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1140 +#: reference_raster.xml:1142 #, no-c-format msgid "Returns a raster with the new band(s) of given type added with given initial value in the given index location. If no index is specified, the band is added to the end." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:1146 +#: reference_raster.xml:1148 #, no-c-format msgid " (1) raster ST_AddBand raster rast addbandarg[] addbandargset (2) raster ST_AddBand raster rast integer index text pixeltype double precision initialvalue=0 double precision nodataval=NULL (3) raster ST_AddBand raster rast text pixeltype double precision initialvalue=0 double precision nodataval=NULL (4) raster ST_AddBand raster torast raster fromrast integer fromband=1 integer torastindex=at_end (5) raster ST_AddBand raster torast raster[] fromrasts integer fromband=1 integer torastindex=at_end (6) raster ST_AddBand raster rast integer index text outdbfile integer[] outdbindex double precision nodataval=NULL (7) raster ST_AddBand raster rast text outdbfile integer[] outdbindex integer index=at_end double precision nodataval=NULL " msgstr "" #. Tag: para -#: reference_raster.xml:1211 +#: reference_raster.xml:1213 #, no-c-format msgid "Returns a raster with a new band added in given position (index), of given type, of given initial value, and of given nodata value. If no index is specified, the band is added to the end. If no fromband is specified, band 1 is assumed. Pixel type is a string representation of one of the pixel types specified in . If an existing index is specified all subsequent bands >= that index are incremented by 1. If an initial value greater than the max of the pixel type is specified, then the initial value is set to the highest value allowed by the pixel type." msgstr "" #. Tag: para -#: reference_raster.xml:1215 +#: reference_raster.xml:1217 #, no-c-format msgid "For the variant that takes an array of (Variant 1), a specific addbandarg's index value is relative to the raster at the time when the band described by that addbandarg is being added to the raster. See the Multiple New Bands example below." msgstr "" #. Tag: para -#: reference_raster.xml:1219 +#: reference_raster.xml:1221 #, no-c-format msgid "For the variant that takes an array of rasters (Variant 5), if torast is NULL then the fromband band of each raster in the array is accumulated into a new raster." msgstr "" #. Tag: para -#: reference_raster.xml:1223 +#: reference_raster.xml:1225 #, no-c-format msgid "For the variants that take outdbfile (Variants 6 and 7), the value must include the full path to the raster file. The file must also be accessible to the postgres server process." msgstr "" #. Tag: para -#: reference_raster.xml:1227 +#: reference_raster.xml:1229 #, no-c-format msgid "Enhanced: 2.1.0 support for addbandarg added." msgstr "" #. Tag: para -#: reference_raster.xml:1228 +#: reference_raster.xml:1230 #, no-c-format msgid "Enhanced: 2.1.0 support for new out-db bands added." msgstr "" #. Tag: title -#: reference_raster.xml:1232 +#: reference_raster.xml:1234 #, no-c-format msgid "Examples: Single New Band" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1234 +#: reference_raster.xml:1236 #, no-c-format msgid "" "-- Add another band of type 8 bit unsigned integer with pixels initialized to 200\n" @@ -1359,7 +1384,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1236 +#: reference_raster.xml:1238 #, no-c-format msgid "" "-- Create an empty raster 100x100 units, with upper left right at 0, add 2 bands (band 1 is 0/1 boolean bit switch, band2 allows values 0-15)\n" @@ -1395,13 +1420,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:1240 +#: reference_raster.xml:1242 #, no-c-format msgid "Examples: Multiple New Bands" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1242 +#: reference_raster.xml:1244 #, no-c-format msgid "" "SELECT\n" @@ -1428,7 +1453,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1244 +#: reference_raster.xml:1246 #, no-c-format msgid "" "-- Aggregate the 1st band of a table of like rasters into a single raster \n" @@ -1445,13 +1470,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:1248 +#: reference_raster.xml:1250 #, no-c-format msgid "Examples: New Out-db band" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1249 +#: reference_raster.xml:1251 #, no-c-format msgid "" "SELECT\n" @@ -1472,103 +1497,103 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1254 +#: reference_raster.xml:1256 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:1267 +#: reference_raster.xml:1269 #, no-c-format msgid "ST_AsRaster" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1268 +#: reference_raster.xml:1270 #, no-c-format msgid "Converts a PostGIS geometry to a PostGIS raster." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:1272 +#: reference_raster.xml:1274 #, no-c-format msgid " raster ST_AsRaster geometry geom raster ref text pixeltype double precision value=1 double precision nodataval=0 boolean touched=false raster ST_AsRaster geometry geom raster ref text[] pixeltype=ARRAY['8BUI'] double precision[] value=ARRAY[1] double precision[] nodataval=ARRAY[0] boolean touched=false raster ST_AsRaster geometry geom double precision scalex double precision scaley double precision gridx double precision gridy text pixeltype double precision value=1 double precision nodataval=0 double precision skewx=0 double precision skewy=0 boolean touched=false raster ST_AsRaster geometry geom double precision scalex double precision scaley double precision gridx=NULL double precision gridy=NULL text[] pixeltype=ARRAY['8BUI'] double precision[] value=ARRAY[1] double precision[] nodataval=ARRAY[0] double precision skewx=0 double precision skewy=0 boolean touched=false raster ST_AsRaster geometry geom double precision scalex double precision scaley text pixeltype double precision value=1 double precision nodataval=0 double precision upperleftx=NULL double precision upperlefty=NULL double precision skewx=0 double precision skewy=0 boolean touched=false raster ST_AsRaster geometry geom double precision scalex double precision scaley text[] pixeltype double precision[] value=ARRAY[1] double precision[] nodataval=ARRAY[0] double precision upperleftx=NULL double precision upperlefty=NULL double precision skewx=0 double precision skewy=0 boolean touched=false raster ST_AsRaster geometry geom integer width integer height double precision gridx double precision gridy text pixeltype double precision value=1 double precision nodataval=0 double precision skewx=0 double precision skewy=0 boolean touched=false raster ST_AsRaster geometry geom integer width integer height double precision gridx=NULL double precision gridy=NULL text[] pixeltype=ARRAY['8BUI'] double precision[] value=ARRAY[1] double precision[] nodataval=ARRAY[0] double precision skewx=0 double precision skewy=0 boolean touched=false raster ST_AsRaster geometry geom integer width integer height text pixeltype double precision value=1 double precision nodataval=0 double precision upperleftx=NULL double precision upperlefty=NULL double precision skewx=0 double precision skewy=0 boolean touched=false raster ST_AsRaster geometry geom integer width integer height text[] pixeltype double precision[] value=ARRAY[1] double precision[] nodataval=ARRAY[0] double precision upperleftx=NULL double precision upperlefty=NULL double precision skewx=0 double precision skewy=0 boolean touched=false " msgstr "" #. Tag: para -#: reference_raster.xml:1420 +#: reference_raster.xml:1422 #, no-c-format msgid "Converts a PostGIS geometry to a PostGIS raster. The many variants offers three groups of possibilities for setting the alignment and pixelsize of the resulting raster." msgstr "" #. Tag: para -#: reference_raster.xml:1422 +#: reference_raster.xml:1424 #, no-c-format msgid "The first group, composed of the two first variants, produce a raster having the same alignment (scalex, scaley, gridx and gridy), pixel type and nodata value as the provided reference raster. You generally pass this reference raster by joining the table containing the geometry with the table containing the reference raster." msgstr "" #. Tag: para -#: reference_raster.xml:1424 +#: reference_raster.xml:1426 #, no-c-format msgid "The second group, composed of four variants, let you set the dimensions of the raster by providing the parameters of a pixel size (scalex & scaley and skewx & skewy). The width & height of the resulting raster will be adjusted to fit the extent of the geometry. In most cases, you must cast integer scalex & scaley arguments to double precision so that PostgreSQL choose the right variant." msgstr "" #. Tag: para -#: reference_raster.xml:1426 +#: reference_raster.xml:1428 #, no-c-format msgid "The third group, composed of four variants, let you fix the dimensions of the raster by providing the dimensions of the raster (width & height). The parameters of the pixel size (scalex & scaley and skewx & skewy) of the resulting raster will be adjusted to fit the extent of the geometry." msgstr "" #. Tag: para -#: reference_raster.xml:1428 +#: reference_raster.xml:1430 #, no-c-format msgid "The two first variants of each of those two last groups let you specify the alignment with an arbitrary corner of the alignment grid (gridx & gridy) and the two last variants takes the upper left corner (upperleftx & upperlefty)." msgstr "" #. Tag: para -#: reference_raster.xml:1430 +#: reference_raster.xml:1432 #, no-c-format msgid "Each group of variant allows producing a one band raster or a multiple bands raster. To produce a multiple bands raster, you must provide an array of pixel types (pixeltype[]), an array of initial values (value) and an array of nodata values (nodataval). If not provided pixeltyped defaults to 8BUI, values to 1 and nodataval to 0." msgstr "" #. Tag: para -#: reference_raster.xml:1432 +#: reference_raster.xml:1434 #, no-c-format msgid "The output raster will be in the same spatial reference as the source geometry. The only exception is for variants with a reference raster. In this case the resulting raster will get the same SRID as the reference raster." msgstr "" #. Tag: para -#: reference_raster.xml:1434 +#: reference_raster.xml:1436 #, no-c-format msgid "The optional touched parameter defaults to false and maps to the GDAL ALL_TOUCHED rasterization option, which determines if pixels touched by lines or polygons will be burned. Not just those on the line render path, or whose center point is within the polygon." msgstr "" #. Tag: para -#: reference_raster.xml:1436 +#: reference_raster.xml:1438 #, no-c-format msgid "This is particularly useful for rendering jpegs and pngs of geometries directly from the database when using in combination with and other family of functions." msgstr "" #. Tag: para -#: reference_raster.xml:1440 +#: reference_raster.xml:1442 #, no-c-format msgid "Not yet capable of rendering complex geometry types such as curves, TINS, and PolyhedralSurfaces, but should be able too once GDAL can." msgstr "" #. Tag: title -#: reference_raster.xml:1445 +#: reference_raster.xml:1447 #, no-c-format msgid "Examples: Output geometries as PNG files" msgstr "" #. Tag: para -#: reference_raster.xml:1451 +#: reference_raster.xml:1453 #, no-c-format msgid "black circle" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1454 +#: reference_raster.xml:1456 #, no-c-format msgid "" "-- this will output a black circle taking up 150 x 150 pixels --\n" @@ -1576,13 +1601,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1461 +#: reference_raster.xml:1463 #, no-c-format msgid "example from buffer rendered with just PostGIS" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1465 +#: reference_raster.xml:1467 #, no-c-format msgid "" "-- the bands map to RGB bands - the value (118,154,118) - teal --\n" @@ -1594,43 +1619,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1471 +#: reference_raster.xml:1473 #, no-c-format msgid ", , , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:1477 +#: reference_raster.xml:1479 #, no-c-format msgid "ST_Band" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1478 +#: reference_raster.xml:1480 #, no-c-format msgid "Returns one or more bands of an existing raster as a new raster. Useful for building new rasters from existing rasters." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:1482 +#: reference_raster.xml:1484 #, no-c-format msgid " raster ST_Band raster rast integer[] nbands = ARRAY[1] raster ST_Band raster rast integer nband raster ST_Band raster rast text nbands character delimiter=, " msgstr "" #. Tag: para -#: reference_raster.xml:1507 +#: reference_raster.xml:1509 #, no-c-format msgid "Returns one or more bands of an existing raster as a new raster. Useful for building new rasters from existing rasters or export of only selected bands of a raster or rearranging the order of bands in a raster. If no band is specified, band 1 is assumed. Used as a helper function in various functions such as for deleting a band." msgstr "" #. Tag: para -#: reference_raster.xml:1509 +#: reference_raster.xml:1511 #, no-c-format msgid "For the nbands as text variant of function, the default delimiter is , which means you can ask for '1,2,3' and if you wanted to use a different delimeter you would do ST_Band(rast, '1@2@3', '@'). For asking for multiple bands, we strongly suggest you use the array form of this function e.g. ST_Band(rast, '{1,2,3}'::int[]); since the text list of bands form may be removed in future versions of PostGIS." msgstr "" #. Tag: programlisting -#: reference_raster.xml:1517 +#: reference_raster.xml:1519 #, no-c-format msgid "" "-- Make 2 new rasters: 1 containing band 1 of dummy, second containing band 2 of dummy and then reclassified as a 2BUI\n" @@ -1647,7 +1672,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1519 +#: reference_raster.xml:1521 #, no-c-format msgid "" "-- Return bands 2 and 3. Using array cast syntax\n" @@ -1665,25 +1690,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1529 +#: reference_raster.xml:1531 #, no-c-format msgid "original (column rast)" msgstr "" #. Tag: para -#: reference_raster.xml:1538 +#: reference_raster.xml:1540 #, no-c-format msgid "dupe_band" msgstr "" #. Tag: para -#: reference_raster.xml:1547 +#: reference_raster.xml:1549 #, no-c-format msgid "sing_band" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1555 +#: reference_raster.xml:1557 #, no-c-format msgid "" "--Make a new raster with 2nd band of original and 1st band repeated twice,\n" @@ -1695,55 +1720,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1561 +#: reference_raster.xml:1563 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_raster.xml:1567 +#: reference_raster.xml:1569 #, no-c-format msgid "ST_MakeEmptyRaster" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1568 +#: reference_raster.xml:1570 #, no-c-format msgid "Returns an empty raster (having no bands) of given dimensions (width & height), upperleft X and Y, pixel size and rotation (scalex, scaley, skewx & skewy) and reference system (srid). If a raster is passed in, returns a new raster with the same size, alignment and SRID. If srid is left out, the spatial ref is set to unknown (0)." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:1572 +#: reference_raster.xml:1574 #, no-c-format msgid " raster ST_MakeEmptyRaster raster rast raster ST_MakeEmptyRaster integer width integer height float8 upperleftx float8 upperlefty float8 scalex float8 scaley float8 skewx float8 skewy integer srid=unknown raster ST_MakeEmptyRaster integer width integer height float8 upperleftx float8 upperlefty float8 pixelsize " msgstr "" #. Tag: para -#: reference_raster.xml:1602 +#: reference_raster.xml:1604 #, no-c-format msgid "Returns an empty raster (having no band) of given dimensions (width & height) and georeferenced in spatial (or world) coordinates with upper left X (upperleftx), upper left Y (upperlefty), pixel size and rotation (scalex, scaley, skewx & skewy) and reference system (srid)." msgstr "" #. Tag: para -#: reference_raster.xml:1605 +#: reference_raster.xml:1607 #, no-c-format msgid "The last version use a single parameter to specify the pixel size (pixelsize). scalex is set to this argument and scaley is set to the negative value of this argument. skewx and skewy are set to 0." msgstr "" #. Tag: para -#: reference_raster.xml:1607 +#: reference_raster.xml:1609 #, no-c-format msgid "If an existing raster is passed in, it returns a new raster with the same meta data settings (without the bands)." msgstr "" #. Tag: para -#: reference_raster.xml:1609 +#: reference_raster.xml:1611 #, no-c-format msgid "If no srid is specified it defaults to 0. After you create an empty raster you probably want to add bands to it and maybe edit it. Refer to to define bands and to set initial pixel values." msgstr "" #. Tag: programlisting -#: reference_raster.xml:1616 +#: reference_raster.xml:1618 #, no-c-format msgid "" "INSERT INTO dummy_rast(rid,rast)\n" @@ -1768,49 +1793,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1622 +#: reference_raster.xml:1624 #, no-c-format msgid ", , , , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:1629 +#: reference_raster.xml:1631 #, no-c-format msgid "ST_Tile" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1630 +#: reference_raster.xml:1632 #, no-c-format msgid "Returns a set of rasters resulting from the split of the input raster based upon the desired dimensions of the output rasters." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:1634 +#: reference_raster.xml:1636 #, no-c-format msgid " setof raster ST_Tile raster rast int[] nband integer width integer height boolean padwithnodata=FALSE double precision nodataval=NULL setof raster ST_Tile raster rast integer nband integer width integer height boolean padwithnodata=FALSE double precision nodataval=NULL setof raster ST_Tile raster rast integer width integer height boolean padwithnodata=FALSE double precision nodataval=NULL " msgstr "" #. Tag: para -#: reference_raster.xml:1670 +#: reference_raster.xml:1672 #, no-c-format msgid "Returns a set of rasters resulting from the split of the input raster based upon the desired dimensions of the output rasters." msgstr "" #. Tag: para -#: reference_raster.xml:1674 +#: reference_raster.xml:1676 #, no-c-format msgid "If padwithnodata = FALSE, edge tiles on the right and bottom sides of the raster may have different dimensions than the rest of the tiles. If padwithnodata = TRUE, all tiles will have the same dimensions with the possibilty that edge tiles being padded with NODATA values. If raster band(s) do not have NODATA value(s) specified, one can be specified by setting nodataval." msgstr "" #. Tag: para -#: reference_raster.xml:1679 +#: reference_raster.xml:1681 #, no-c-format msgid "If a specified band of the input raster is out-of-db, the corresponding band in the output rasters will also be out-of-db." msgstr "" #. Tag: programlisting -#: reference_raster.xml:1690 +#: reference_raster.xml:1692 #, no-c-format msgid "" "WITH foo AS (\n" @@ -1858,7 +1883,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1692 +#: reference_raster.xml:1694 #, no-c-format msgid "" "WITH foo AS (\n" @@ -1897,67 +1922,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1698 +#: reference_raster.xml:1700 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:1708 +#: reference_raster.xml:1710 #, no-c-format msgid "ST_Retile" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1709 +#: reference_raster.xml:1711 #, no-c-format msgid "Return a set of configured tiles from an arbitrarily tiled raster coverage." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:1717 +#: reference_raster.xml:1719 #, no-c-format msgid "SETOF raster ST_Retile regclass tab name col geometry ext float8 sfx float8 sfy int tw int th text algo='NearestNeighbor'" msgstr "" #. Tag: para -#: reference_raster.xml:1735 +#: reference_raster.xml:1737 #, no-c-format msgid "Return a set of tiles having the specified scale (sfx, sfy) and max size (tw, th) and covering the specified extent (ext) with data coming from the specified raster coverage (tab, col)." msgstr "" #. Tag: refname -#: reference_raster.xml:1759 +#: reference_raster.xml:1761 #, no-c-format msgid "ST_FromGDALRaster" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1760 +#: reference_raster.xml:1762 #, no-c-format msgid "Returns a raster from a supported GDAL raster file." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:1765 +#: reference_raster.xml:1767 #, no-c-format msgid "raster ST_FromGDALRaster bytea gdaldata integer srid=NULL" msgstr "" #. Tag: para -#: reference_raster.xml:1777 +#: reference_raster.xml:1779 #, no-c-format msgid "Returns a raster from a supported GDAL raster file. gdaldata is of type bytea and should be the contents of the GDAL raster file." msgstr "" #. Tag: para -#: reference_raster.xml:1781 +#: reference_raster.xml:1783 #, no-c-format msgid "If srid is NULL, the function will try to autmatically assign the SRID from the GDAL raster. If srid is provided, the value provided will override any automatically assigned SRID." msgstr "" #. Tag: programlisting -#: reference_raster.xml:1791 +#: reference_raster.xml:1793 #, no-c-format msgid "" "WITH foo AS (\n" @@ -1985,49 +2010,49 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:1806 +#: reference_raster.xml:1808 #, no-c-format msgid "Raster Accessors" msgstr "" #. Tag: refname -#: reference_raster.xml:1810 +#: reference_raster.xml:1812 #, no-c-format msgid "ST_GeoReference" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1811 +#: reference_raster.xml:1813 #, no-c-format msgid "Returns the georeference meta data in GDAL or ESRI format as commonly seen in a world file. Default is GDAL." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:1816 +#: reference_raster.xml:1818 #, no-c-format msgid "text ST_GeoReference raster rast text format=GDAL" msgstr "" #. Tag: para -#: reference_raster.xml:1827 +#: reference_raster.xml:1829 #, no-c-format msgid "Returns the georeference meta data including carriage return in GDAL or ESRI format as commonly seen in a world file. Default is GDAL if no type specified. type is string 'GDAL' or 'ESRI'." msgstr "" #. Tag: para -#: reference_raster.xml:1829 reference_raster.xml:4065 +#: reference_raster.xml:1831 reference_raster.xml:4068 #, no-c-format msgid "Difference between format representations is as follows:" msgstr "" #. Tag: para -#: reference_raster.xml:1830 reference_raster.xml:4066 +#: reference_raster.xml:1832 reference_raster.xml:4069 #, no-c-format msgid "GDAL:" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1831 +#: reference_raster.xml:1833 #, no-c-format msgid "" "scalex \n" @@ -2039,13 +2064,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1832 reference_raster.xml:4068 +#: reference_raster.xml:1834 reference_raster.xml:4071 #, no-c-format msgid "ESRI:" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1833 +#: reference_raster.xml:1835 #, no-c-format msgid "" "scalex \n" @@ -2057,7 +2082,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1839 +#: reference_raster.xml:1841 #, no-c-format msgid "" "SELECT ST_GeoReference(rast, 'ESRI') As esri_ref, ST_GeoReference(rast, 'GDAL') As gdal_ref\n" @@ -2074,37 +2099,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1844 +#: reference_raster.xml:1846 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:1850 +#: reference_raster.xml:1852 #, no-c-format msgid "ST_Height" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1851 +#: reference_raster.xml:1853 #, no-c-format msgid "Returns the height of the raster in pixels." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:1856 +#: reference_raster.xml:1858 #, no-c-format msgid "integer ST_Height raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:1866 +#: reference_raster.xml:1868 #, no-c-format msgid "Returns the height of the raster." msgstr "" #. Tag: programlisting -#: reference_raster.xml:1872 +#: reference_raster.xml:1874 #, no-c-format msgid "" "SELECT rid, ST_Height(rast) As rastheight\n" @@ -2117,31 +2142,31 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:1884 +#: reference_raster.xml:1886 #, no-c-format msgid "ST_IsEmpty" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1885 +#: reference_raster.xml:1887 #, no-c-format msgid "Returns true if the raster is empty (width = 0 and height = 0). Otherwise, returns false." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:1890 +#: reference_raster.xml:1892 #, no-c-format msgid "boolean ST_IsEmpty raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:1900 +#: reference_raster.xml:1902 #, no-c-format msgid "Returns true if the raster is empty (width = 0 and height = 0). Otherwise, returns false." msgstr "" #. Tag: programlisting -#: reference_raster.xml:1908 +#: reference_raster.xml:1910 #, no-c-format msgid "" "SELECT ST_IsEmpty(ST_MakeEmptyRaster(100, 100, 0, 0, 0, 0, 0, 0))\n" @@ -2157,49 +2182,49 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:1920 +#: reference_raster.xml:1922 #, no-c-format msgid "ST_MemSize" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1922 +#: reference_raster.xml:1924 #, no-c-format msgid "Returns the amount of space (in bytes) the raster takes." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:1927 +#: reference_raster.xml:1929 #, no-c-format msgid "integer ST_MemSize raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:1937 +#: reference_raster.xml:1939 #, no-c-format msgid "Returns the amount of space (in bytes) the raster takes." msgstr "" #. Tag: para -#: reference_raster.xml:1938 +#: reference_raster.xml:1940 #, 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_raster.xml:1939 +#: reference_raster.xml:1941 #, 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. pg_column_size might return lower because it returns the compressed size." msgstr "" #. Tag: para -#: reference_raster.xml:1941 +#: reference_raster.xml:1943 #, no-c-format msgid "pg_total_relation_size - includes, the table, the toasted tables, and the indexes." msgstr "" #. Tag: programlisting -#: reference_raster.xml:1951 +#: reference_raster.xml:1953 #, no-c-format msgid "" "SELECT ST_MemSize(ST_AsRaster(ST_Buffer(ST_Point(1,5),10,1000),150, 150, '8BUI')) As rast_mem;\n" @@ -2210,31 +2235,31 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:1964 +#: reference_raster.xml:1966 #, no-c-format msgid "ST_MetaData" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1965 +#: reference_raster.xml:1967 #, no-c-format msgid "Returns basic meta data about a raster object such as pixel size, rotation (skew), upper, lower left, etc." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:1970 +#: reference_raster.xml:1972 #, no-c-format msgid "record ST_MetaData raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:1980 +#: reference_raster.xml:1982 #, no-c-format msgid "Returns basic meta data about a raster object such as pixel size, rotation (skew), upper, lower left, etc. Columns returned: upperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbands" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1987 +#: reference_raster.xml:1989 #, no-c-format msgid "" "SELECT rid, (foo.md).* \n" @@ -2248,37 +2273,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1993 reference_raster.xml:4844 +#: reference_raster.xml:1995 reference_raster.xml:4847 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:1999 +#: reference_raster.xml:2001 #, no-c-format msgid "ST_NumBands" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2000 +#: reference_raster.xml:2002 #, no-c-format msgid "Returns the number of bands in the raster object." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2005 +#: reference_raster.xml:2007 #, no-c-format msgid "integer ST_NumBands raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:2015 +#: reference_raster.xml:2017 #, no-c-format msgid "Returns the number of bands in the raster object." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2021 +#: reference_raster.xml:2023 #, no-c-format msgid "" "SELECT rid, ST_NumBands(rast) As numbands\n" @@ -2291,43 +2316,43 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2033 +#: reference_raster.xml:2035 #, no-c-format msgid "ST_PixelHeight" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2034 +#: reference_raster.xml:2036 #, no-c-format msgid "Returns the pixel height in geometric units of the spatial reference system." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2039 +#: reference_raster.xml:2041 #, no-c-format msgid "double precision ST_PixelHeight raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:2049 +#: reference_raster.xml:2051 #, no-c-format msgid "Returns the height of a pixel in geometric units of the spatial reference system. In the common case where there is no skew, the pixel height is just the scale ratio between geometric coordinates and raster pixels." msgstr "" #. Tag: para -#: reference_raster.xml:2051 +#: reference_raster.xml:2053 #, no-c-format msgid "Refer to for a diagrammatic visualization of the relationship." msgstr "" #. Tag: title -#: reference_raster.xml:2055 reference_raster.xml:2115 +#: reference_raster.xml:2057 reference_raster.xml:2117 #, no-c-format msgid "Examples: Rasters with no skew" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2057 +#: reference_raster.xml:2059 #, no-c-format msgid "" "SELECT ST_Height(rast) As rastheight, ST_PixelHeight(rast) As pixheight,\n" @@ -2342,13 +2367,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:2062 reference_raster.xml:2122 +#: reference_raster.xml:2064 reference_raster.xml:2124 #, no-c-format msgid "Examples: Rasters with skew different than 0" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2064 +#: reference_raster.xml:2066 #, no-c-format msgid "" "SELECT ST_Height(rast) As rastheight, ST_PixelHeight(rast) As pixheight,\n" @@ -2364,55 +2389,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2071 reference_raster.xml:2131 reference_raster.xml:4124 +#: reference_raster.xml:2073 reference_raster.xml:2133 reference_raster.xml:4127 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:2083 +#: reference_raster.xml:2085 #, no-c-format msgid "ST_PixelWidth" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2084 +#: reference_raster.xml:2086 #, no-c-format msgid "Returns the pixel width in geometric units of the spatial reference system." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2089 +#: reference_raster.xml:2091 #, no-c-format msgid "double precision ST_PixelWidth raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:2099 +#: reference_raster.xml:2101 #, no-c-format msgid "Returns the width of a pixel in geometric units of the spatial reference system. In the common case where there is no skew, the pixel width is just the scale ratio between geometric coordinates and raster pixels." msgstr "" #. Tag: para -#: reference_raster.xml:2101 +#: reference_raster.xml:2103 #, no-c-format msgid "The following diagram demonstrates the relationship:" msgstr "" #. Tag: para -#: reference_raster.xml:2108 +#: reference_raster.xml:2110 #, no-c-format msgid "Pixel Width: Pixel size in the i direction" msgstr "" #. Tag: para -#: reference_raster.xml:2108 +#: reference_raster.xml:2110 #, no-c-format msgid "Pixel Height: Pixel size in the j direction" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2117 +#: reference_raster.xml:2119 #, no-c-format msgid "" "SELECT ST_Width(rast) As rastwidth, ST_PixelWidth(rast) As pixwidth,\n" @@ -2427,7 +2452,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2124 +#: reference_raster.xml:2126 #, no-c-format msgid "" "SELECT ST_Width(rast) As rastwidth, ST_PixelWidth(rast) As pixwidth,\n" @@ -2443,37 +2468,37 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2137 +#: reference_raster.xml:2139 #, no-c-format msgid "ST_ScaleX" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2138 +#: reference_raster.xml:2140 #, no-c-format msgid "Returns the X component of the pixel width in units of coordinate reference system." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2143 +#: reference_raster.xml:2145 #, no-c-format msgid "float8 ST_ScaleX raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:2153 +#: reference_raster.xml:2155 #, no-c-format msgid "Returns the X component of the pixel width in units of coordinate reference system. Refer to World File for more details." msgstr "" #. Tag: para -#: reference_raster.xml:2155 +#: reference_raster.xml:2157 #, no-c-format msgid "Changed: 2.0.0. In WKTRaster versions this was called ST_PixelSizeX." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2161 +#: reference_raster.xml:2163 #, no-c-format msgid "" "SELECT rid, ST_ScaleX(rast) As rastpixwidth\n" @@ -2486,37 +2511,37 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2174 +#: reference_raster.xml:2176 #, no-c-format msgid "ST_ScaleY" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2175 +#: reference_raster.xml:2177 #, no-c-format msgid "Returns the Y component of the pixel height in units of coordinate reference system." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2180 +#: reference_raster.xml:2182 #, no-c-format msgid "float8 ST_ScaleY raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:2190 +#: reference_raster.xml:2192 #, no-c-format msgid "Returns the Y component of the pixel height in units of coordinate reference system. May be negative. Refer to World File for more details." msgstr "" #. Tag: para -#: reference_raster.xml:2193 +#: reference_raster.xml:2195 #, no-c-format msgid "Changed: 2.0.0. In WKTRaster versions this was called ST_PixelSizeY." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2199 +#: reference_raster.xml:2201 #, no-c-format msgid "" "SELECT rid, ST_ScaleY(rast) As rastpixheight\n" @@ -2529,31 +2554,31 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2212 +#: reference_raster.xml:2214 #, no-c-format msgid "ST_RasterToWorldCoord" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2213 +#: reference_raster.xml:2215 #, no-c-format msgid "Returns the raster's upper left corner as geometric X and Y (longitude and latitude) given a column and row. Column and row starts at 1." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2218 +#: reference_raster.xml:2220 #, no-c-format msgid "record ST_RasterToWorldCoord raster rast integer xcolumn integer yrow" msgstr "" #. Tag: para -#: reference_raster.xml:2230 +#: reference_raster.xml:2232 #, no-c-format msgid "Returns the upper left corner as geometric X and Y (longitude and latitude) given a column and row. Returned X and Y are in geometric units of the georeferenced raster. Numbering of column and row starts at 1 but if either parameter is passed a zero, a negative number or a number greater than the respective dimension of the raster, it will return coordinates outside of the raster assuming the raster's grid is applicable outside the raster's bounds." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2242 +#: reference_raster.xml:2244 #, no-c-format msgid "" "-- non-skewed raster\n" @@ -2570,7 +2595,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2244 +#: reference_raster.xml:2246 #, no-c-format msgid "" "-- skewed raster\n" @@ -2592,49 +2617,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2251 +#: reference_raster.xml:2253 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:2261 +#: reference_raster.xml:2263 #, no-c-format msgid "ST_RasterToWorldCoordX" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2262 +#: reference_raster.xml:2264 #, no-c-format msgid "Returns the geometric X coordinate upper left of a raster, column and row. Numbering of columns and rows starts at 1." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:2267 +#: reference_raster.xml:2269 #, no-c-format msgid " float8 ST_RasterToWorldCoordX raster rast integer xcolumn float8 ST_RasterToWorldCoordX raster rast integer xcolumn integer yrow " msgstr "" #. Tag: para -#: reference_raster.xml:2285 +#: reference_raster.xml:2287 #, no-c-format msgid "Returns the upper left X coordinate of a raster column row in geometric units of the georeferenced raster. Numbering of columns and rows starts at 1 but if you pass in a negative number or number higher than number of columns in raster, it will give you coordinates outside of the raster file to left or right with the assumption that the skew and pixel sizes are same as selected raster." msgstr "" #. Tag: para -#: reference_raster.xml:2290 +#: reference_raster.xml:2292 #, no-c-format msgid "For non-skewed rasters, providing the X column is sufficient. For skewed rasters, the georeferenced coordinate is a function of the ST_ScaleX and ST_SkewX and row and column. An error will be raised if you give just the X column for a skewed raster." msgstr "" #. Tag: para -#: reference_raster.xml:2294 +#: reference_raster.xml:2296 #, no-c-format msgid "Changed: 2.1.0 In prior versions, this was called ST_Raster2WorldCoordX" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2301 +#: reference_raster.xml:2303 #, no-c-format msgid "" "-- non-skewed raster providing column is sufficient \n" @@ -2650,7 +2675,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2303 +#: reference_raster.xml:2305 #, no-c-format msgid "" "-- for fun lets skew it \n" @@ -2666,49 +2691,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2310 +#: reference_raster.xml:2312 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_raster.xml:2316 +#: reference_raster.xml:2318 #, no-c-format msgid "ST_RasterToWorldCoordY" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2317 +#: reference_raster.xml:2319 #, no-c-format msgid "Returns the geometric Y coordinate upper left corner of a raster, column and row. Numbering of columns and rows starts at 1." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:2322 +#: reference_raster.xml:2324 #, no-c-format msgid " float8 ST_RasterToWorldCoordY raster rast integer yrow float8 ST_RasterToWorldCoordY raster rast integer xcolumn integer yrow " msgstr "" #. Tag: para -#: reference_raster.xml:2340 +#: reference_raster.xml:2342 #, no-c-format msgid "Returns the upper left Y coordinate of a raster column row in geometric units of the georeferenced raster. Numbering of columns and rows starts at 1 but if you pass in a negative number or number higher than number of columns/rows in raster, it will give you coordinates outside of the raster file to left or right with the assumption that the skew and pixel sizes are same as selected raster tile." msgstr "" #. Tag: para -#: reference_raster.xml:2345 +#: reference_raster.xml:2347 #, no-c-format msgid "For non-skewed rasters, providing the Y column is sufficient. For skewed rasters, the georeferenced coordinate is a function of the ST_ScaleY and ST_SkewY and row and column. An error will be raised if you give just the Y row for a skewed raster." msgstr "" #. Tag: para -#: reference_raster.xml:2349 +#: reference_raster.xml:2351 #, no-c-format msgid "Changed: 2.1.0 In prior versions, this was called ST_Raster2WorldCoordY" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2355 +#: reference_raster.xml:2357 #, no-c-format msgid "" "-- non-skewed raster providing row is sufficient \n" @@ -2724,7 +2749,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2357 +#: reference_raster.xml:2359 #, no-c-format msgid "" "-- for fun lets skew it \n" @@ -2740,37 +2765,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2364 +#: reference_raster.xml:2366 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_raster.xml:2370 +#: reference_raster.xml:2372 #, no-c-format msgid "ST_Rotation" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2371 +#: reference_raster.xml:2373 #, no-c-format msgid "Returns the rotation of the raster in radian." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2376 +#: reference_raster.xml:2378 #, no-c-format msgid "float8 ST_Rotation raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:2386 +#: reference_raster.xml:2388 #, no-c-format msgid "Returns the uniform rotation of the raster in radian. If a raster does not have uniform rotation, NaN is returned. Refer to World File for more details." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2393 +#: reference_raster.xml:2395 #, no-c-format msgid "" "SELECT rid, ST_Rotation(ST_SetScale(ST_SetSkew(rast, sqrt(2)), sqrt(2))) as rot FROM dummy_rast;\n" @@ -2782,37 +2807,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2399 +#: reference_raster.xml:2401 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:2405 +#: reference_raster.xml:2407 #, no-c-format msgid "ST_SkewX" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2406 +#: reference_raster.xml:2408 #, no-c-format msgid "Returns the georeference X skew (or rotation parameter)." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2411 +#: reference_raster.xml:2413 #, no-c-format msgid "float8 ST_SkewX raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:2421 +#: reference_raster.xml:2423 #, no-c-format msgid "Returns the georeference X skew (or rotation parameter). Refer to World File for more details." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2428 reference_raster.xml:2464 +#: reference_raster.xml:2430 reference_raster.xml:2466 #, no-c-format msgid "" "SELECT rid, ST_SkewX(rast) As skewx, ST_SkewY(rast) As skewy, \n" @@ -2837,73 +2862,73 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2435 +#: reference_raster.xml:2437 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:2441 +#: reference_raster.xml:2443 #, no-c-format msgid "ST_SkewY" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2442 +#: reference_raster.xml:2444 #, no-c-format msgid "Returns the georeference Y skew (or rotation parameter)." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2447 +#: reference_raster.xml:2449 #, no-c-format msgid "float8 ST_SkewY raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:2457 +#: reference_raster.xml:2459 #, no-c-format msgid "Returns the georeference Y skew (or rotation parameter). Refer to World File for more details." msgstr "" #. Tag: para -#: reference_raster.xml:2471 +#: reference_raster.xml:2473 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:2477 +#: reference_raster.xml:2479 #, no-c-format msgid "ST_SRID" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2478 +#: reference_raster.xml:2480 #, no-c-format msgid "Returns the spatial reference identifier of the raster as defined in spatial_ref_sys table." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2483 +#: reference_raster.xml:2485 #, no-c-format msgid "integer ST_SRID raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:2493 +#: reference_raster.xml:2495 #, no-c-format msgid "Returns the spatial reference identifier of the raster object as defined in the spatial_ref_sys table." msgstr "" #. Tag: para -#: reference_raster.xml:2494 +#: reference_raster.xml:2496 #, no-c-format msgid "From PostGIS 2.0+ the srid of a non-georeferenced raster/geometry is 0 instead of the prior -1." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2500 +#: reference_raster.xml:2502 #, no-c-format msgid "" "SELECT ST_SRID(rast) As srid\n" @@ -2914,32 +2939,38 @@ msgid "" "0" msgstr "" +#. Tag: para +#: reference_raster.xml:2508 +#, no-c-format +msgid ", " +msgstr "" + #. Tag: refname -#: reference_raster.xml:2512 +#: reference_raster.xml:2514 #, no-c-format msgid "ST_Summary" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2513 +#: reference_raster.xml:2515 #, no-c-format msgid "Returns a text summary of the contents of the raster." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2518 +#: reference_raster.xml:2520 #, no-c-format msgid "text ST_Summary raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:2528 +#: reference_raster.xml:2530 #, no-c-format msgid "Returns a text summary of the contents of the raster." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2535 +#: reference_raster.xml:2537 #, no-c-format msgid "" "SELECT ST_Summary(\n" @@ -2965,37 +2996,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2540 +#: reference_raster.xml:2542 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:2551 +#: reference_raster.xml:2553 #, no-c-format msgid "ST_UpperLeftX" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2552 +#: reference_raster.xml:2554 #, no-c-format msgid "Returns the upper left X coordinate of raster in projected spatial ref." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2557 +#: reference_raster.xml:2559 #, no-c-format msgid "float8 ST_UpperLeftX raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:2567 +#: reference_raster.xml:2569 #, no-c-format msgid "Returns the upper left X coordinate of raster in projected spatial ref." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2573 +#: reference_raster.xml:2575 #, no-c-format msgid "" "SELECt rid, ST_UpperLeftX(rast) As ulx\n" @@ -3008,37 +3039,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2579 reference_raster.xml:2613 +#: reference_raster.xml:2581 reference_raster.xml:2615 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:2585 +#: reference_raster.xml:2587 #, no-c-format msgid "ST_UpperLeftY" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2586 +#: reference_raster.xml:2588 #, no-c-format msgid "Returns the upper left Y coordinate of raster in projected spatial ref." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2591 +#: reference_raster.xml:2593 #, no-c-format msgid "float8 ST_UpperLeftY raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:2601 +#: reference_raster.xml:2603 #, no-c-format msgid "Returns the upper left Y coordinate of raster in projected spatial ref." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2607 +#: reference_raster.xml:2609 #, no-c-format msgid "" "SELECT rid, ST_UpperLeftY(rast) As uly\n" @@ -3051,31 +3082,31 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2619 +#: reference_raster.xml:2621 #, no-c-format msgid "ST_Width" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2620 +#: reference_raster.xml:2622 #, no-c-format msgid "Returns the width of the raster in pixels." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2625 +#: reference_raster.xml:2627 #, no-c-format msgid "integer ST_Width raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:2635 +#: reference_raster.xml:2637 #, no-c-format msgid "Returns the width of the raster in pixels." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2641 +#: reference_raster.xml:2643 #, no-c-format msgid "" "SELECT ST_Width(rast) As rastwidth\n" @@ -3087,31 +3118,31 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2655 +#: reference_raster.xml:2657 #, no-c-format msgid "ST_WorldToRasterCoord" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2656 +#: reference_raster.xml:2658 #, no-c-format msgid "Returns the upper left corner as column and row given geometric X and Y (longitude and latitude) or a point geometry expressed in the spatial reference coordinate system of the raster." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:2660 +#: reference_raster.xml:2662 #, no-c-format msgid " record ST_WorldToRasterCoord raster rast geometry pt record ST_WorldToRasterCoord raster rast double precision longitude double precision latitude " msgstr "" #. Tag: para -#: reference_raster.xml:2679 +#: reference_raster.xml:2681 #, no-c-format msgid "Returns the upper left corner as column and row given geometric X and Y (longitude and latitude) or a point geometry. This function works regardless of whether or not the geometric X and Y or point geometry is outside the extent of the raster. Geometric X and Y must be expressed in the spatial reference coordinate system of the raster." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2692 +#: reference_raster.xml:2694 #, no-c-format msgid "" "SELECT\n" @@ -3127,43 +3158,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2698 +#: reference_raster.xml:2700 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:2710 +#: reference_raster.xml:2712 #, no-c-format msgid "ST_WorldToRasterCoordX" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2711 +#: reference_raster.xml:2713 #, no-c-format msgid "Returns the column in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw) represented in world spatial reference system of raster." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:2716 +#: reference_raster.xml:2718 #, no-c-format msgid " integer ST_WorldToRasterCoordX raster rast geometry pt integer ST_WorldToRasterCoordX raster rast double precision xw integer ST_WorldToRasterCoordX raster rast double precision xw double precision yw " msgstr "" #. Tag: para -#: reference_raster.xml:2741 +#: reference_raster.xml:2743 #, no-c-format msgid "Returns the column in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw). A point, or (both xw and yw world coordinates are required if a raster is skewed). If a raster is not skewed then xw is sufficient. World coordinates are in the spatial reference coordinate system of the raster." msgstr "" #. Tag: para -#: reference_raster.xml:2743 +#: reference_raster.xml:2745 #, no-c-format msgid "Changed: 2.1.0 In prior versions, this was called ST_World2RasterCoordX" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2749 +#: reference_raster.xml:2751 #, no-c-format msgid "" "SELECT rid, ST_WorldToRasterCoordX(rast,3427927.8) As xcoord, \n" @@ -3178,43 +3209,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2755 reference_raster.xml:2810 +#: reference_raster.xml:2757 reference_raster.xml:2812 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:2765 +#: reference_raster.xml:2767 #, no-c-format msgid "ST_WorldToRasterCoordY" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2766 +#: reference_raster.xml:2768 #, no-c-format msgid "Returns the row in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw) represented in world spatial reference system of raster." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:2771 +#: reference_raster.xml:2773 #, no-c-format msgid " integer ST_WorldToRasterCoordY raster rast geometry pt integer ST_WorldToRasterCoordY raster rast double precision xw integer ST_WorldToRasterCoordY raster rast double precision xw double precision yw " msgstr "" #. Tag: para -#: reference_raster.xml:2796 +#: reference_raster.xml:2798 #, no-c-format msgid "Returns the row in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw). A point, or (both xw and yw world coordinates are required if a raster is skewed). If a raster is not skewed then xw is sufficient. World coordinates are in the spatial reference coordinate system of the raster." msgstr "" #. Tag: para -#: reference_raster.xml:2798 +#: reference_raster.xml:2800 #, no-c-format msgid "Changed: 2.1.0 In prior versions, this was called ST_World2RasterCoordY" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2804 +#: reference_raster.xml:2806 #, no-c-format msgid "" "SELECT rid, ST_WorldToRasterCoordY(rast,20.5) As ycoord, \n" @@ -3229,49 +3260,49 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:2817 +#: reference_raster.xml:2819 #, no-c-format msgid "Raster Band Accessors" msgstr "" #. Tag: refname -#: reference_raster.xml:2820 +#: reference_raster.xml:2822 #, no-c-format msgid "ST_BandMetaData" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2821 +#: reference_raster.xml:2823 #, no-c-format msgid "Returns basic meta data for a specific raster band. band num 1 is assumed if none-specified." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2826 +#: reference_raster.xml:2828 #, no-c-format msgid "record ST_BandMetaData raster rast integer bandnum=1" msgstr "" #. Tag: para -#: reference_raster.xml:2837 +#: reference_raster.xml:2839 #, no-c-format msgid "Returns basic meta data about a raster band. Columns returned pixeltype | nodatavalue | isoutdb | path." msgstr "" #. Tag: para -#: reference_raster.xml:2841 +#: reference_raster.xml:2843 #, no-c-format msgid "If raster contains no bands then an error is thrown." msgstr "" #. Tag: para -#: reference_raster.xml:2846 +#: reference_raster.xml:2848 #, no-c-format msgid "If band has no NODATA value, nodatavalue will be NULL." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2855 +#: reference_raster.xml:2857 #, no-c-format msgid "" "SELECT rid, (foo.md).* \n" @@ -3284,37 +3315,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2861 +#: reference_raster.xml:2863 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:2867 +#: reference_raster.xml:2869 #, no-c-format msgid "ST_BandNoDataValue" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2868 +#: reference_raster.xml:2870 #, no-c-format msgid "Returns the value in a given band that represents no data. If no band num 1 is assumed." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2873 +#: reference_raster.xml:2875 #, no-c-format msgid "double precision ST_BandNoDataValue raster rast integer bandnum=1" msgstr "" #. Tag: para -#: reference_raster.xml:2884 reference_raster.xml:3012 +#: reference_raster.xml:2886 reference_raster.xml:3014 #, no-c-format msgid "Returns the value that represents no data for the band" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2890 +#: reference_raster.xml:2892 #, no-c-format msgid "" "SELECT ST_BandNoDataValue(rast,1) As bnval1, \n" @@ -3328,37 +3359,37 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2903 +#: reference_raster.xml:2905 #, no-c-format msgid "ST_BandIsNoData" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2904 +#: reference_raster.xml:2906 #, no-c-format msgid "Returns true if the band is filled with only nodata values." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:2908 +#: reference_raster.xml:2910 #, no-c-format msgid " boolean ST_BandIsNoData raster rast integer band boolean forceChecking=true boolean ST_BandIsNoData raster rast boolean forceChecking=true " msgstr "" #. Tag: para -#: reference_raster.xml:2925 +#: reference_raster.xml:2927 #, no-c-format msgid "Returns true if the band is filled with only nodata values. Band 1 is assumed if not specified. If the last argument is TRUE, the entire band is checked pixel by pixel. Otherwise, the function simply returns the value of the isnodata flag for the band. The default value for this parameter is FALSE, if not specified." msgstr "" #. Tag: para -#: reference_raster.xml:2935 +#: reference_raster.xml:2937 #, no-c-format msgid "If the flag is dirty (this is, the result is different using TRUE as last parameter and not using it) you should update the raster to set this flag to true, by using ST_SetBandIsNodata(), or ST_SetBandNodataValue() with TRUE as last argument. See ." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2945 +#: reference_raster.xml:2947 #, no-c-format msgid "" "-- Create dummy table with one raster column\n" @@ -3415,133 +3446,133 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2951 +#: reference_raster.xml:2953 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_raster.xml:2960 +#: reference_raster.xml:2962 #, no-c-format msgid "ST_BandPath" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2961 +#: reference_raster.xml:2963 #, no-c-format msgid "Returns system file path to a band stored in file system. If no bandnum specified, 1 is assumed." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2966 +#: reference_raster.xml:2968 #, no-c-format msgid "text ST_BandPath raster rast integer bandnum=1" msgstr "" #. Tag: para -#: reference_raster.xml:2977 +#: reference_raster.xml:2979 #, no-c-format msgid "Returns system file path to a band. Throws an error if called with an in db band." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2983 +#: reference_raster.xml:2985 #, no-c-format msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2995 +#: reference_raster.xml:2997 #, no-c-format msgid "ST_BandPixelType" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2996 +#: reference_raster.xml:2998 #, no-c-format msgid "Returns the type of pixel for given band. If no bandnum specified, 1 is assumed." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3001 +#: reference_raster.xml:3003 #, no-c-format msgid "text ST_BandPixelType raster rast integer bandnum=1" msgstr "" #. Tag: para -#: reference_raster.xml:3013 +#: reference_raster.xml:3015 #, no-c-format msgid "There are 11 pixel types. Pixel Types supported are as follows:" msgstr "" #. Tag: para -#: reference_raster.xml:3016 +#: reference_raster.xml:3018 #, no-c-format msgid "1BB - 1-bit boolean" msgstr "" #. Tag: para -#: reference_raster.xml:3020 +#: reference_raster.xml:3022 #, no-c-format msgid "2BUI - 2-bit unsigned integer" msgstr "" #. Tag: para -#: reference_raster.xml:3024 +#: reference_raster.xml:3026 #, no-c-format msgid "4BUI - 4-bit unsigned integer" msgstr "" #. Tag: para -#: reference_raster.xml:3028 +#: reference_raster.xml:3030 #, no-c-format msgid "8BSI - 8-bit signed integer" msgstr "" #. Tag: para -#: reference_raster.xml:3031 +#: reference_raster.xml:3033 #, no-c-format msgid "8BUI - 8-bit unsigned integer" msgstr "" #. Tag: para -#: reference_raster.xml:3034 +#: reference_raster.xml:3036 #, no-c-format msgid "16BSI - 16-bit signed integer" msgstr "" #. Tag: para -#: reference_raster.xml:3037 +#: reference_raster.xml:3039 #, no-c-format msgid "16BUI - 16-bit unsigned integer" msgstr "" #. Tag: para -#: reference_raster.xml:3040 +#: reference_raster.xml:3042 #, no-c-format msgid "32BSI - 32-bit signed integer" msgstr "" #. Tag: para -#: reference_raster.xml:3043 +#: reference_raster.xml:3045 #, no-c-format msgid "32BUI - 32-bit unsigned integer" msgstr "" #. Tag: para -#: reference_raster.xml:3046 +#: reference_raster.xml:3048 #, no-c-format msgid "32BF - 32-bit float" msgstr "" #. Tag: para -#: reference_raster.xml:3049 +#: reference_raster.xml:3051 #, no-c-format msgid "64BF - 64-bit float" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3058 +#: reference_raster.xml:3060 #, no-c-format msgid "" "SELECT ST_BandPixelType(rast,1) As btype1, \n" @@ -3555,31 +3586,31 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:3070 +#: reference_raster.xml:3072 #, no-c-format msgid "ST_HasNoBand" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3071 +#: reference_raster.xml:3073 #, no-c-format msgid "Returns true if there is no band with given band number. If no band number is specified, then band number 1 is assumed." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3076 +#: reference_raster.xml:3078 #, no-c-format msgid "boolean ST_HasNoBand raster rast integer bandnum=1" msgstr "" #. Tag: para -#: reference_raster.xml:3087 +#: reference_raster.xml:3089 #, no-c-format msgid "Returns true if there is no band with given band number. If no band number is specified, then band number 1 is assumed." msgstr "" #. Tag: programlisting -#: reference_raster.xml:3095 +#: reference_raster.xml:3097 #, no-c-format msgid "" "SELECT rid, ST_HasNoBand(rast) As hb1, ST_HasNoBand(rast,2) as hb2, \n" @@ -3593,37 +3624,37 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:3108 +#: reference_raster.xml:3110 #, no-c-format msgid "Raster Pixel Accessors and Setters" msgstr "" #. Tag: refname -#: reference_raster.xml:3112 +#: reference_raster.xml:3114 #, no-c-format msgid "ST_PixelAsPolygon" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3113 +#: reference_raster.xml:3115 #, no-c-format msgid "Returns the polygon geometry that bounds the pixel for a particular row and column." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3118 +#: reference_raster.xml:3120 #, no-c-format msgid "geometry ST_PixelAsPolygon raster rast integer columnx integer rowy" msgstr "" #. Tag: para -#: reference_raster.xml:3130 +#: reference_raster.xml:3132 #, no-c-format msgid "Returns the polygon geometry that bounds the pixel for a particular row and column." msgstr "" #. Tag: programlisting -#: reference_raster.xml:3138 +#: reference_raster.xml:3140 #, no-c-format msgid "" "-- get raster pixel polygon\n" @@ -3640,61 +3671,61 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3143 +#: reference_raster.xml:3145 #, no-c-format msgid ", , , , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:3158 +#: reference_raster.xml:3160 #, no-c-format msgid "ST_PixelAsPolygons" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3159 +#: reference_raster.xml:3161 #, no-c-format msgid "Returns the polygon geometry that bounds every pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3164 +#: reference_raster.xml:3166 #, no-c-format msgid "setof record ST_PixelAsPolygons raster rast integer band=1 boolean exclude_nodata_value=TRUE" msgstr "" #. Tag: para -#: reference_raster.xml:3176 +#: reference_raster.xml:3178 #, no-c-format msgid "Returns the polygon geometry that bounds every pixel of a raster band along with the value (double precision), the X and the Y raster coordinates (integers) of each pixel." msgstr "" #. Tag: para -#: reference_raster.xml:3179 +#: reference_raster.xml:3181 #, no-c-format msgid "ST_PixelAsPolygons returns one polygon geometry for every pixel. This is different than ST_DumpAsPolygons where each geometry represents one or more pixels with the same pixel value." msgstr "" #. Tag: para -#: reference_raster.xml:3184 +#: reference_raster.xml:3186 #, no-c-format msgid "When exclude_nodata_value = TRUE, only those pixels whose values are not NODATA are returned as polygons." msgstr "" #. Tag: para -#: reference_raster.xml:3190 +#: reference_raster.xml:3192 #, no-c-format msgid "Enhanced: 2.1.0 exclude_nodata_value optional argument was added." msgstr "" #. Tag: para -#: reference_raster.xml:3191 reference_raster.xml:3285 reference_raster.xml:3379 +#: reference_raster.xml:3193 reference_raster.xml:3287 reference_raster.xml:3381 #, no-c-format msgid "Changed: 2.1.1 Changed behavior of exclude_nodata_value." msgstr "" #. Tag: programlisting -#: reference_raster.xml:3196 +#: reference_raster.xml:3198 #, no-c-format msgid "" "-- get raster pixel polygon\n" @@ -3716,37 +3747,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3201 +#: reference_raster.xml:3203 #, no-c-format msgid ", , , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:3215 +#: reference_raster.xml:3217 #, no-c-format msgid "ST_PixelAsPoint" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3216 +#: reference_raster.xml:3218 #, no-c-format msgid "Returns a point geometry of the pixel's upper-left corner." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3222 +#: reference_raster.xml:3224 #, no-c-format msgid "geometry ST_PixelAsPoint raster rast integer columnx integer rowy" msgstr "" #. Tag: para -#: reference_raster.xml:3233 +#: reference_raster.xml:3235 #, no-c-format msgid "Returns a point geometry of the pixel's upper-left corner." msgstr "" #. Tag: programlisting -#: reference_raster.xml:3239 +#: reference_raster.xml:3241 #, no-c-format msgid "" "SELECT ST_AsText(ST_PixelAsPoint(rast, 1, 1)) FROM dummy_rast WHERE rid = 1;\n" @@ -3757,43 +3788,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3244 +#: reference_raster.xml:3246 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:3258 +#: reference_raster.xml:3260 #, no-c-format msgid "ST_PixelAsPoints" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3259 +#: reference_raster.xml:3261 #, no-c-format msgid "Returns a point geometry for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The coordinates of the point geometry are of the pixel's upper-left corner." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3265 +#: reference_raster.xml:3267 #, no-c-format msgid "geometry ST_PixelAsPoints raster rast integer band=1 boolean exclude_nodata_value=TRUE" msgstr "" #. Tag: para -#: reference_raster.xml:3276 +#: reference_raster.xml:3278 #, no-c-format msgid "Returns a point geometry for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The coordinates of the point geometry are of the pixel's upper-left corner." msgstr "" #. Tag: para -#: reference_raster.xml:3280 reference_raster.xml:3374 +#: reference_raster.xml:3282 reference_raster.xml:3376 #, no-c-format msgid "When exclude_nodata_value = TRUE, only those pixels whose values are not NODATA are returned as points." msgstr "" #. Tag: programlisting -#: reference_raster.xml:3290 +#: reference_raster.xml:3292 #, no-c-format msgid "" "SELECT x, y, val, ST_AsText(geom) FROM (SELECT (ST_PixelAsPoints(rast, 1)).* FROM dummy_rast WHERE rid = 2) foo;\n" @@ -3828,37 +3859,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3295 +#: reference_raster.xml:3297 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:3309 +#: reference_raster.xml:3311 #, no-c-format msgid "ST_PixelAsCentroid" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3310 +#: reference_raster.xml:3312 #, no-c-format msgid "Returns the centroid (point geometry) of the area represented by a pixel." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3316 +#: reference_raster.xml:3318 #, no-c-format msgid "geometry ST_PixelAsCentroid raster rast integer columnx integer rowy" msgstr "" #. Tag: para -#: reference_raster.xml:3327 +#: reference_raster.xml:3329 #, no-c-format msgid "Returns the centroid (point geometry) of the area represented by a pixel." msgstr "" #. Tag: programlisting -#: reference_raster.xml:3333 +#: reference_raster.xml:3335 #, no-c-format msgid "" "SELECT ST_AsText(ST_PixelAsCentroid(rast, 1, 1)) FROM dummy_rast WHERE rid = 1;\n" @@ -3869,37 +3900,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3338 +#: reference_raster.xml:3340 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:3352 +#: reference_raster.xml:3354 #, no-c-format msgid "ST_PixelAsCentroids" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3353 +#: reference_raster.xml:3355 #, no-c-format msgid "Returns the centroid (point geometry) for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The point geometry is the centroid of the area represented by a pixel." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3359 +#: reference_raster.xml:3361 #, no-c-format msgid "geometry ST_PixelAsCentroids raster rast integer band=1 boolean exclude_nodata_value=TRUE" msgstr "" #. Tag: para -#: reference_raster.xml:3370 +#: reference_raster.xml:3372 #, no-c-format msgid "Returns the centroid (point geometry) for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The point geometry is the centroid of the area represented by a pixel." msgstr "" #. Tag: programlisting -#: reference_raster.xml:3384 +#: reference_raster.xml:3386 #, no-c-format msgid "" "SELECT x, y, val, ST_AsText(geom) FROM (SELECT (ST_PixelAsCentroids(rast, 1)).* FROM dummy_rast WHERE rid = 2) foo;\n" @@ -3933,43 +3964,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3389 +#: reference_raster.xml:3391 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:3403 +#: reference_raster.xml:3405 #, no-c-format msgid "ST_Value" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3404 +#: reference_raster.xml:3406 #, no-c-format msgid "Returns the value of a given band in a given columnx, rowy pixel or at a particular geometric point. Band numbers start at 1 and assumed to be 1 if not specified. If exclude_nodata_value is set to false, then all pixels include nodata pixels are considered to intersect and return value. If exclude_nodata_value is not passed in then reads it from metadata of raster." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:3408 +#: reference_raster.xml:3410 #, no-c-format msgid " double precision ST_Value raster rast geometry pt boolean exclude_nodata_value=true double precision ST_Value raster rast integer bandnum geometry pt boolean exclude_nodata_value=true double precision ST_Value raster rast integer columnx integer rowy boolean exclude_nodata_value=true double precision ST_Value raster rast integer bandnum integer columnx integer rowy boolean exclude_nodata_value=true " msgstr "" #. Tag: para -#: reference_raster.xml:3443 +#: reference_raster.xml:3445 #, no-c-format msgid "Returns the value of a given band in a given columnx, rowy pixel or at a given geometry point. Band numbers start at 1 and band is assumed to be 1 if not specified. If exclude_nodata_value is set to true, then only non nodata pixels are considered. If exclude_nodata_value is set to false, then all pixels are considered." msgstr "" #. Tag: para -#: reference_raster.xml:3446 +#: reference_raster.xml:3448 #, no-c-format msgid "Enhanced: 2.0.0 exclude_nodata_value optional argument was added." msgstr "" #. Tag: programlisting -#: reference_raster.xml:3451 +#: reference_raster.xml:3453 #, no-c-format msgid "" "-- get raster values at particular postgis geometry points\n" @@ -3990,7 +4021,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3452 +#: reference_raster.xml:3454 #, no-c-format msgid "" "SELECT rid, ST_Value(rast, 1, 1, 1) As b1pval, \n" @@ -4004,7 +4035,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3454 +#: reference_raster.xml:3456 #, no-c-format msgid "" "--- Get all values in bands 1,2,3 of each pixel --\n" @@ -4028,7 +4059,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3456 +#: reference_raster.xml:3458 #, no-c-format msgid "" "--- Get all values in bands 1,2,3 of each pixel same as above but returning the upper left point point of each pixel --\n" @@ -4051,7 +4082,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3457 +#: reference_raster.xml:3459 #, no-c-format msgid "" "--- Get a polygon formed by union of all pixels \n" @@ -4089,7 +4120,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3459 +#: reference_raster.xml:3461 #, no-c-format msgid "" "--- Checking all the pixels of a large raster tile can take a long time.\n" @@ -4124,49 +4155,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3464 +#: reference_raster.xml:3466 #, no-c-format msgid ", , , , , , , , , , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:3485 +#: reference_raster.xml:3487 #, no-c-format msgid "ST_NearestValue" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3486 +#: reference_raster.xml:3488 #, no-c-format msgid "Returns the nearest non-NODATA value of a given band's pixel specified by a columnx and rowy or a geometric point expressed in the same spatial reference coordinate system as the raster." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:3492 +#: reference_raster.xml:3494 #, no-c-format msgid " double precision ST_NearestValue raster rast integer bandnum geometry pt boolean exclude_nodata_value=true double precision ST_NearestValue raster rast geometry pt boolean exclude_nodata_value=true double precision ST_NearestValue raster rast integer bandnum integer columnx integer rowy boolean exclude_nodata_value=true double precision ST_NearestValue raster rast integer columnx integer rowy boolean exclude_nodata_value=true " msgstr "" #. Tag: para -#: reference_raster.xml:3529 +#: reference_raster.xml:3531 #, no-c-format msgid "Returns the nearest non-NODATA value of a given band in a given columnx, rowy pixel or at a specific geometric point. If the columnx, rowy pixel or the pixel at the specified geometric point is NODATA, the function will find the nearest pixel to the columnx, rowy pixel or geometric point whose value is not NODATA." msgstr "" #. Tag: para -#: reference_raster.xml:3532 reference_raster.xml:3619 +#: reference_raster.xml:3534 reference_raster.xml:3621 #, no-c-format msgid "Band numbers start at 1 and bandnum is assumed to be 1 if not specified. If exclude_nodata_value is set to false, then all pixels include nodata pixels are considered to intersect and return value. If exclude_nodata_value is not passed in then reads it from metadata of raster." msgstr "" #. Tag: para -#: reference_raster.xml:3537 +#: reference_raster.xml:3539 #, no-c-format msgid "ST_NearestValue is a drop-in replacement for ST_Value." msgstr "" #. Tag: programlisting -#: reference_raster.xml:3546 +#: reference_raster.xml:3548 #, no-c-format msgid "" "-- pixel 2x2 has value\n" @@ -4202,7 +4233,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3548 +#: reference_raster.xml:3550 #, no-c-format msgid "" "-- pixel 2x3 is NODATA\n" @@ -4238,49 +4269,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3554 +#: reference_raster.xml:3556 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:3564 +#: reference_raster.xml:3566 #, no-c-format msgid "ST_Neighborhood" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3565 +#: reference_raster.xml:3567 #, no-c-format msgid "Returns a 2-D double precision array of the non-NODATA values around a given band's pixel specified by either a columnX and rowY or a geometric point expressed in the same spatial reference coordinate system as the raster." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:3571 +#: reference_raster.xml:3573 #, no-c-format msgid " double precision[][] ST_Neighborhood raster rast integer bandnum integer columnX integer rowY integer distanceX integer distanceY boolean exclude_nodata_value=true double precision[][] ST_Neighborhood raster rast integer columnX integer rowY integer distanceX integer distanceY boolean exclude_nodata_value=true double precision[][] ST_Neighborhood raster rast integer bandnum geometry pt integer distanceX integer distanceY boolean exclude_nodata_value=true double precision[][] ST_Neighborhood raster rast geometry pt integer distanceX integer distanceY boolean exclude_nodata_value=true " msgstr "" #. Tag: para -#: reference_raster.xml:3616 +#: reference_raster.xml:3618 #, no-c-format msgid "Returns a 2-D double precision array of the non-NODATA values around a given band's pixel specified by either a columnX and rowY or a geometric point expressed in the same spatial reference coordinate system as the raster. The distanceX and distanceY parameters define the number of pixels around the specified pixel in the X and Y axes, e.g. I want all values within 3 pixel distance along the X axis and 2 pixel distance along the Y axis around my pixel of interest. The center value of the 2-D array will be the value at the pixel specified by the columnX and rowY or the geometric point." msgstr "" #. Tag: para -#: reference_raster.xml:3623 +#: reference_raster.xml:3625 #, no-c-format msgid "The number of elements along each axis of the returning 2-D array is 2 * (distanceX|distanceY) + 1. So for a distanceX and distanceY of 1, the returning array will be 3x3." msgstr "" #. Tag: para -#: reference_raster.xml:3628 +#: reference_raster.xml:3630 #, no-c-format msgid "The 2-D array output can be passed to any of the raster processing builtin functions, e.g. ST_Min4ma, ST_Sum4ma, ST_Mean4ma." msgstr "" #. Tag: programlisting -#: reference_raster.xml:3638 +#: reference_raster.xml:3640 #, no-c-format msgid "" "-- pixel 2x2 has value\n" @@ -4310,7 +4341,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3640 +#: reference_raster.xml:3642 #, no-c-format msgid "" "-- pixel 2x3 is NODATA\n" @@ -4340,7 +4371,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3642 +#: reference_raster.xml:3644 #, no-c-format msgid "" "-- pixel 3x3 has value\n" @@ -4370,43 +4401,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3648 +#: reference_raster.xml:3650 #, no-c-format msgid ", , , , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:3665 +#: reference_raster.xml:3667 #, no-c-format msgid "ST_SetValue" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3666 +#: reference_raster.xml:3668 #, no-c-format msgid "Returns modified raster resulting from setting the value of a given band in a given columnx, rowy pixel or the pixels that intersect a particular geometry. Band numbers start at 1 and assumed to be 1 if not specified." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:3670 +#: reference_raster.xml:3672 #, no-c-format msgid " raster ST_SetValue raster rast integer bandnum geometry geom double precision newvalue raster ST_SetValue raster rast geometry geom double precision newvalue raster ST_SetValue raster rast integer bandnum integer columnx integer rowy double precision newvalue raster ST_SetValue raster rast integer columnx integer rowy double precision newvalue " msgstr "" #. Tag: para -#: reference_raster.xml:3704 +#: reference_raster.xml:3706 #, no-c-format msgid "Returns modified raster resulting from setting the specified pixels' values to new value for the designed band given the raster's row and column or a geometry. If no band is specified, then band 1 is assumed." msgstr "" #. Tag: para -#: reference_raster.xml:3707 +#: reference_raster.xml:3709 #, no-c-format msgid "Enhanced: 2.1.0 Geometry variant of ST_SetValue() now supports any geometry type, not just point. The geometry variant is a wrapper around the geomval[] variant of ST_SetValues()" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3713 +#: reference_raster.xml:3715 #, no-c-format msgid "" "-- Geometry example\n" @@ -4428,7 +4459,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3715 +#: reference_raster.xml:3717 #, no-c-format msgid "" "-- Store the changed raster --\n" @@ -4437,79 +4468,79 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3719 reference_raster.xml:9319 +#: reference_raster.xml:3721 reference_raster.xml:9322 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:3725 +#: reference_raster.xml:3727 #, no-c-format msgid "ST_SetValues" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3726 +#: reference_raster.xml:3728 #, no-c-format msgid "Returns modified raster resulting from setting the values of a given band." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:3730 +#: reference_raster.xml:3732 #, no-c-format msgid " raster ST_SetValues raster rast integer nband integer columnx integer rowy double precision[][] newvalueset boolean[][] noset=NULL boolean keepnodata=FALSE raster ST_SetValues raster rast integer nband integer columnx integer rowy double precision[][] newvalueset double precision nosetvalue boolean keepnodata=FALSE raster ST_SetValues raster rast integer nband integer columnx integer rowy integer width integer height double precision newvalue boolean keepnodata=FALSE raster ST_SetValues raster rast integer columnx integer rowy integer width integer height double precision newvalue boolean keepnodata=FALSE raster ST_SetValues raster rast integer nband geomval[] geomvalset boolean keepnodata=FALSE " msgstr "" #. Tag: para -#: reference_raster.xml:3789 +#: reference_raster.xml:3791 #, no-c-format msgid "Returns modified raster resulting from setting specified pixels to new value(s) for the designated band." msgstr "" #. Tag: para -#: reference_raster.xml:3793 +#: reference_raster.xml:3795 #, no-c-format msgid "If keepnodata is TRUE, those pixels whose values are NODATA will not be set with the corresponding value in newvalueset." msgstr "" #. Tag: para -#: reference_raster.xml:3797 +#: reference_raster.xml:3799 #, no-c-format msgid "For Variant 1, the specific pixels to be set are determined by the columnx, rowy pixel coordinates and the dimensions of the newvalueset array. noset can be used to prevent pixels with values present in newvalueset from being set (due to PostgreSQL not permitting ragged/jagged arrays). See example Variant 1." msgstr "" #. Tag: para -#: reference_raster.xml:3801 +#: reference_raster.xml:3803 #, no-c-format msgid "Variant 2 is like Variant 1 but with a simple double precision nosetvalue instead of a boolean noset array. Elements in newvalueset with the nosetvalue value with be skipped. See example Variant 2." msgstr "" #. Tag: para -#: reference_raster.xml:3805 +#: reference_raster.xml:3807 #, no-c-format msgid "For Variant 3, the specific pixels to be set are determined by the columnx, rowy pixel coordinates, width and height. See example Variant 3." msgstr "" #. Tag: para -#: reference_raster.xml:3809 +#: reference_raster.xml:3811 #, no-c-format msgid "Variant 4 is the same as Variant 3 with the exception that it assumes that the first band's pixels of rast will be set." msgstr "" #. Tag: para -#: reference_raster.xml:3813 +#: reference_raster.xml:3815 #, no-c-format msgid "For Variant 5, an array of is used to determine the specific pixels to be set. If all the geometries in the array are of type POINT or MULTIPOINT, the function uses a shortcut where the longitude and latitude of each point is used to set a pixel directly. Otherwise, the geometries are converted to rasters and then iterated through in one pass. See example Variant 5." msgstr "" #. Tag: title -#: reference_raster.xml:3822 reference_raster.xml:6730 reference_raster.xml:8262 reference_raster.xml:8705 reference_raster.xml:8802 reference_raster.xml:8930 +#: reference_raster.xml:3824 reference_raster.xml:6733 reference_raster.xml:8265 reference_raster.xml:8708 reference_raster.xml:8805 reference_raster.xml:8933 #, no-c-format msgid "Examples: Variant 1" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3824 +#: reference_raster.xml:3826 #, no-c-format msgid "" "/*\n" @@ -4555,7 +4586,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3826 +#: reference_raster.xml:3828 #, no-c-format msgid "" "/*\n" @@ -4601,7 +4632,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3828 +#: reference_raster.xml:3830 #, no-c-format msgid "" "/*\n" @@ -4649,7 +4680,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3830 +#: reference_raster.xml:3832 #, no-c-format msgid "" "/*\n" @@ -4701,13 +4732,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:3835 reference_raster.xml:8269 reference_raster.xml:8710 reference_raster.xml:8807 reference_raster.xml:8935 +#: reference_raster.xml:3837 reference_raster.xml:8272 reference_raster.xml:8713 reference_raster.xml:8810 reference_raster.xml:8938 #, no-c-format msgid "Examples: Variant 2" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3837 +#: reference_raster.xml:3839 #, no-c-format msgid "" "/*\n" @@ -4753,7 +4784,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3839 +#: reference_raster.xml:3841 #, no-c-format msgid "" "/*\n" @@ -4801,13 +4832,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:3844 reference_raster.xml:4788 +#: reference_raster.xml:3846 reference_raster.xml:4791 #, no-c-format msgid "Examples: Variant 3" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3846 +#: reference_raster.xml:3848 #, no-c-format msgid "" "/*\n" @@ -4853,7 +4884,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3848 +#: reference_raster.xml:3850 #, no-c-format msgid "" "/*\n" @@ -4902,13 +4933,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:3853 +#: reference_raster.xml:3855 #, no-c-format msgid "Examples: Variant 5" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3855 +#: reference_raster.xml:3857 #, no-c-format msgid "" "WITH foo AS (\n" @@ -4935,13 +4966,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3857 +#: reference_raster.xml:3859 #, no-c-format msgid "The following shows that geomvals later in the array can overwrite prior geomvals" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3858 +#: reference_raster.xml:3860 #, no-c-format msgid "" "WITH foo AS (\n" @@ -4968,13 +4999,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3860 +#: reference_raster.xml:3862 #, no-c-format msgid "This example is the opposite of the prior example" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3861 +#: reference_raster.xml:3863 #, no-c-format msgid "" "WITH foo AS (\n" @@ -5001,37 +5032,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3868 +#: reference_raster.xml:3870 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:3878 +#: reference_raster.xml:3880 #, no-c-format msgid "ST_DumpValues" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3879 +#: reference_raster.xml:3881 #, no-c-format msgid "Get the values of the specified band as a 2-dimension array." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:3885 +#: reference_raster.xml:3887 #, no-c-format -msgid " setof record ST_DumpValues raster rast integer[] nband boolean exclude_nodata_value=true double precision[][] ST_DumpValues raster rast integer nband boolean exclude_nodata_value=true " +msgid " setof record ST_DumpValues raster rast integer[] nband=NULL boolean exclude_nodata_value=true double precision[][] ST_DumpValues raster rast integer nband boolean exclude_nodata_value=true " msgstr "" #. Tag: para -#: reference_raster.xml:3916 +#: reference_raster.xml:3918 #, no-c-format -msgid "Get the values of the specified band as a 2-dimension array. If nband is NULL or not provided, all raster bands are processed." +msgid "Get the values of the specified band as a 2-dimension array (first index is row, second is column). If nband is NULL or not provided, all raster bands are processed." msgstr "" #. Tag: programlisting -#: reference_raster.xml:3926 +#: reference_raster.xml:3928 #, no-c-format msgid "" "WITH foo AS (\n" @@ -5050,7 +5081,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3928 +#: reference_raster.xml:3930 #, no-c-format msgid "" "WITH foo AS (\n" @@ -5067,38 +5098,55 @@ msgid "" "(2 rows)" msgstr "" +#. Tag: programlisting +#: reference_raster.xml:3931 +#, no-c-format +msgid "" + "WITH foo AS (\n" + " SELECT ST_SetValue(ST_AddBand(ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, 0), 1, '8BUI', 1, 0), 1, 2, 5) AS rast\n" + ")\n" + "SELECT\n" + " (ST_DumpValues(rast, 1))[2][1]\n" + "FROM foo;\n" + "\n" + " st_dumpvalues\n" + "---------------\n" + " 5\n" + "(1 row)" +msgstr "" + #. Tag: para -#: reference_raster.xml:3933 +#: reference_raster.xml:3936 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:3944 +#: reference_raster.xml:3947 #, no-c-format msgid "ST_PixelOfValue" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3945 +#: reference_raster.xml:3948 #, no-c-format msgid "Get the columnx, rowy coordinates of the pixel whose value equals the search value." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:3951 +#: reference_raster.xml:3954 #, no-c-format msgid " setof record ST_PixelOfValue raster rast integer nband double precision[] search boolean exclude_nodata_value=true setof record ST_PixelOfValue raster rast double precision[] search boolean exclude_nodata_value=true setof record ST_PixelOfValue raster rast integer nband double precision search boolean exclude_nodata_value=true setof record ST_PixelOfValue raster rast double precision search boolean exclude_nodata_value=true " msgstr "" #. Tag: para -#: reference_raster.xml:4012 +#: reference_raster.xml:4015 #, no-c-format msgid "Get the columnx, rowy coordinates of the pixel whose value equals the search value. If no band is specified, then band 1 is assumed." msgstr "" #. Tag: programlisting -#: reference_raster.xml:4021 +#: reference_raster.xml:4024 #, no-c-format msgid "" "SELECT\n" @@ -5154,61 +5202,61 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:4029 +#: reference_raster.xml:4032 #, no-c-format msgid "Raster Editors" msgstr "" #. Tag: refname -#: reference_raster.xml:4033 +#: reference_raster.xml:4036 #, no-c-format msgid "ST_SetGeoReference" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4034 +#: reference_raster.xml:4037 #, no-c-format msgid "Set Georeference 6 georeference parameters in a single call. Numbers should be separated by white space. Accepts inputs in GDAL or ESRI format. Default is GDAL." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4038 +#: reference_raster.xml:4041 #, no-c-format msgid " raster ST_SetGeoReference raster rast text georefcoords text format=GDAL raster ST_SetGeoReference raster rast double precision upperleftx double precision upperlefty double precision scalex double precision scaley double precision skewx double precision skewy " msgstr "" #. Tag: para -#: reference_raster.xml:4064 +#: reference_raster.xml:4067 #, no-c-format msgid "Set Georeference 6 georeference parameters in a single call. Accepts inputs in 'GDAL' or 'ESRI' format. Default is GDAL. If 6 coordinates are not provided will return null." msgstr "" #. Tag: programlisting -#: reference_raster.xml:4067 +#: reference_raster.xml:4070 #, no-c-format msgid "scalex skewy skewx scaley upperleftx upperlefty" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4069 +#: reference_raster.xml:4072 #, no-c-format msgid "scalex skewy skewx scaley upperleftx + scalex*0.5 upperlefty + scaley*0.5" msgstr "" #. Tag: para -#: reference_raster.xml:4072 +#: reference_raster.xml:4075 #, no-c-format msgid "If the raster has out-db bands, changing the georeference may result in incorrect access of the band's externally stored data." msgstr "" #. Tag: para -#: reference_raster.xml:4077 +#: reference_raster.xml:4080 #, no-c-format msgid "Enhanced: 2.1.0 Addition of ST_SetGeoReference(raster, double precision, ...) variant" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4084 +#: reference_raster.xml:4087 #, no-c-format msgid "" "WITH foo AS (\n" @@ -5239,37 +5287,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4089 +#: reference_raster.xml:4092 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:4095 +#: reference_raster.xml:4098 #, no-c-format msgid "ST_SetRotation" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4096 +#: reference_raster.xml:4099 #, no-c-format msgid "Set the rotation of the raster in radian." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:4101 +#: reference_raster.xml:4104 #, no-c-format msgid "float8 ST_SetRotation raster rast float8 rotation" msgstr "" #. Tag: para -#: reference_raster.xml:4112 +#: reference_raster.xml:4115 #, no-c-format msgid "Uniformly rotate the raster. Rotation is in radian. Refer to World File for more details." msgstr "" #. Tag: programlisting -#: reference_raster.xml:4118 +#: reference_raster.xml:4121 #, no-c-format msgid "" "SELECT \n" @@ -5285,43 +5333,43 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:4131 +#: reference_raster.xml:4134 #, no-c-format msgid "ST_SetScale" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4132 +#: reference_raster.xml:4135 #, no-c-format msgid "Sets the X and Y size of pixels in units of coordinate reference system. Number units/pixel width/height." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4136 +#: reference_raster.xml:4139 #, no-c-format msgid " raster ST_SetScale raster rast float8 xy raster ST_SetScale raster rast float8 x float8 y " msgstr "" #. Tag: para -#: reference_raster.xml:4155 +#: reference_raster.xml:4158 #, no-c-format msgid "Sets the X and Y size of pixels in units of coordinate reference system. Number units/pixel width/height. If only one unit passed in, assumed X and Y are the same number." msgstr "" #. Tag: para -#: reference_raster.xml:4158 +#: reference_raster.xml:4161 #, no-c-format msgid "ST_SetScale is different from in that ST_SetScale do not resample the raster to match the raster extent. It only changes the metadata (or georeference) of the raster to correct an originally mis-specified scaling. ST_Rescale results in a raster having different width and height computed to fit the geographic extent of the input raster. ST_SetScale do not modify the width, nor the height of the raster." msgstr "" #. Tag: para -#: reference_raster.xml:4160 +#: reference_raster.xml:4163 #, no-c-format msgid "Changed: 2.0.0 In WKTRaster versions this was called ST_SetPixelSize. This was changed in 2.0.0." msgstr "" #. Tag: programlisting -#: reference_raster.xml:4166 +#: reference_raster.xml:4169 #, no-c-format msgid "" "UPDATE dummy_rast \n" @@ -5338,7 +5386,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4167 +#: reference_raster.xml:4170 #, no-c-format msgid "" "UPDATE dummy_rast \n" @@ -5355,37 +5403,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4173 +#: reference_raster.xml:4176 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:4179 +#: reference_raster.xml:4182 #, no-c-format msgid "ST_SetSkew" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4180 +#: reference_raster.xml:4183 #, no-c-format msgid "Sets the georeference X and Y skew (or rotation parameter). If only one is passed in, sets X and Y to the same value." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4184 +#: reference_raster.xml:4187 #, no-c-format msgid " raster ST_SetSkew raster rast float8 skewxy raster ST_SetSkew raster rast float8 skewx float8 skewy " msgstr "" #. Tag: para -#: reference_raster.xml:4202 +#: reference_raster.xml:4205 #, no-c-format msgid "Sets the georeference X and Y skew (or rotation parameter). If only one is passed in, sets X and Y to the same value. Refer to World File for more details." msgstr "" #. Tag: programlisting -#: reference_raster.xml:4209 +#: reference_raster.xml:4212 #, no-c-format msgid "" "-- Example 1 \n" @@ -5405,7 +5453,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4211 +#: reference_raster.xml:4214 #, no-c-format msgid "" "-- Example 2 set both to same number:\n" @@ -5425,73 +5473,73 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4218 +#: reference_raster.xml:4221 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_raster.xml:4224 +#: reference_raster.xml:4227 #, no-c-format msgid "ST_SetSRID" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4226 +#: reference_raster.xml:4229 #, no-c-format msgid "Sets the SRID of a raster to a particular integer srid defined in the spatial_ref_sys table." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:4231 +#: reference_raster.xml:4234 #, no-c-format msgid "raster ST_SetSRID raster rast integer srid" msgstr "" #. Tag: para -#: reference_raster.xml:4246 +#: reference_raster.xml:4249 #, no-c-format msgid "Sets the SRID on a raster to a particular integer value." msgstr "" #. Tag: para -#: reference_raster.xml:4249 +#: reference_raster.xml:4252 #, no-c-format msgid "This function does not transform the raster in any way - it simply sets meta data defining the spatial ref of the coordinate reference system that it's currently in. Useful for transformations later." msgstr "" #. Tag: para -#: reference_raster.xml:4259 +#: reference_raster.xml:4262 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:4266 +#: reference_raster.xml:4269 #, no-c-format msgid "ST_SetUpperLeft" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4267 +#: reference_raster.xml:4270 #, no-c-format msgid "Sets the value of the upper left corner of the pixel to projected X and Y coordinates." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:4272 +#: reference_raster.xml:4275 #, no-c-format msgid "raster ST_SetUpperLeft raster rast double precision x double precision y" msgstr "" #. Tag: para -#: reference_raster.xml:4284 +#: reference_raster.xml:4287 #, no-c-format msgid "Set the value of the upper left corner of raster to the projected X coordinates" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4290 +#: reference_raster.xml:4293 #, no-c-format msgid "" "SELECT ST_SetUpperLeft(rast,-71.01,42.37) \n" @@ -5500,67 +5548,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4296 +#: reference_raster.xml:4299 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:4302 +#: reference_raster.xml:4305 #, no-c-format msgid "ST_Resample" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4303 +#: reference_raster.xml:4306 #, no-c-format msgid "Resample a raster using a specified resampling algorithm, new dimensions, an arbitrary grid corner and a set of raster georeferencing attributes defined or borrowed from another raster." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4309 +#: reference_raster.xml:4312 #, no-c-format msgid " raster ST_Resample raster rast integer width integer height double precision gridx=NULL double precision gridy=NULL double precision skewx=0 double precision skewy=0 text algorithm=NearestNeighbour double precision maxerr=0.125 raster ST_Resample raster rast double precision scalex=0 double precision scaley=0 double precision gridx=NULL double precision gridy=NULL double precision skewx=0 double precision skewy=0 text algorithm=NearestNeighbor double precision maxerr=0.125 raster ST_Resample raster rast raster ref text algorithm=NearestNeighbour double precision maxerr=0.125 boolean usescale=true raster ST_Resample raster rast raster ref boolean usescale text algorithm=NearestNeighbour double precision maxerr=0.125 " msgstr "" #. Tag: para -#: reference_raster.xml:4359 +#: reference_raster.xml:4362 #, no-c-format msgid "Resample a raster using a specified resampling algorithm, new dimensions (width & height), a grid corner (gridx & gridy) and a set of raster georeferencing attributes (scalex, scaley, skewx & skewy) defined or borrowed from another raster. If using a reference raster, the two rasters must have the same SRID." msgstr "" #. Tag: para -#: reference_raster.xml:4363 +#: reference_raster.xml:4366 #, no-c-format msgid "New pixel values are computed using the NearestNeighbor (English or American spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. Default is NearestNeighbor which is the fastest but produce the worst interpolation." msgstr "" #. Tag: para -#: reference_raster.xml:4367 reference_raster.xml:4434 +#: reference_raster.xml:4370 reference_raster.xml:4437 #, no-c-format msgid "A maxerror percent of 0.125 is used if no maxerr is specified." msgstr "" #. Tag: para -#: reference_raster.xml:4372 reference_raster.xml:4436 reference_raster.xml:4504 reference_raster.xml:4582 +#: reference_raster.xml:4375 reference_raster.xml:4439 reference_raster.xml:4507 reference_raster.xml:4585 #, no-c-format msgid "Refer to: GDAL Warp resampling methods for more details." msgstr "" #. Tag: para -#: reference_raster.xml:4376 reference_raster.xml:4440 reference_raster.xml:4508 reference_raster.xml:4586 reference_raster.xml:4742 +#: reference_raster.xml:4379 reference_raster.xml:4443 reference_raster.xml:4511 reference_raster.xml:4589 reference_raster.xml:4745 #, no-c-format msgid "Availability: 2.0.0 Requires GDAL 1.6.1+" msgstr "" #. Tag: para -#: reference_raster.xml:4377 +#: reference_raster.xml:4380 #, no-c-format msgid "Changed: 2.1.0 Parameter srid removed. Variants with a reference raster no longer applies the reference raster's SRID. Use ST_Transform() to reproject raster. Works on rasters with no SRID." msgstr "" #. Tag: programlisting -#: reference_raster.xml:4383 +#: reference_raster.xml:4386 #, no-c-format msgid "" "SELECT\n" @@ -5584,67 +5632,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4388 +#: reference_raster.xml:4391 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:4398 +#: reference_raster.xml:4401 #, no-c-format msgid "ST_Rescale" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4399 +#: reference_raster.xml:4402 #, no-c-format msgid "Resample a raster by adjusting only its scale (or pixel size). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. Default is NearestNeighbor." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4404 +#: reference_raster.xml:4407 #, no-c-format msgid " raster ST_Rescale raster rast double precision scalexy text algorithm=NearestNeighbour double precision maxerr=0.125 raster ST_Rescale raster rast double precision scalex double precision scaley text algorithm=NearestNeighbour double precision maxerr=0.125 " msgstr "" #. Tag: para -#: reference_raster.xml:4428 +#: reference_raster.xml:4431 #, no-c-format msgid "Resample a raster by adjusting only its scale (or pixel size). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. The default is NearestNeighbor which is the fastest but results in the worst interpolation." msgstr "" #. Tag: para -#: reference_raster.xml:4430 +#: reference_raster.xml:4433 #, no-c-format msgid "scalex and scaley define the new pixel size. scaley must often be negative to get well oriented raster." msgstr "" #. Tag: para -#: reference_raster.xml:4432 +#: reference_raster.xml:4435 #, no-c-format msgid "When the new scalex or scaley is not a divisor of the raster width or height, the extent of the resulting raster is expanded to encompass the extent of the provided raster. If you want to be sure to retain exact input extent see " msgstr "" #. Tag: para -#: reference_raster.xml:4438 +#: reference_raster.xml:4441 #, no-c-format msgid "ST_Rescale is different from in that ST_SetScale do not resample the raster to match the raster extent. ST_SetScale only changes the metadata (or georeference) of the raster to correct an originally mis-specified scaling. ST_Rescale results in a raster having different width and height computed to fit the geographic extent of the input raster. ST_SetScale do not modify the width, nor the height of the raster." msgstr "" #. Tag: para -#: reference_raster.xml:4441 reference_raster.xml:4509 reference_raster.xml:4587 +#: reference_raster.xml:4444 reference_raster.xml:4512 reference_raster.xml:4590 #, no-c-format msgid "Changed: 2.1.0 Works on rasters with no SRID" msgstr "" #. Tag: para -#: reference_raster.xml:4446 +#: reference_raster.xml:4449 #, no-c-format msgid "A simple example rescaling a raster from a pixel size of 0.001 degree to a pixel size of 0.0015 degree." msgstr "" #. Tag: programlisting -#: reference_raster.xml:4448 +#: reference_raster.xml:4451 #, no-c-format msgid "" "-- the original raster pixel size\n" @@ -5663,67 +5711,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4453 +#: reference_raster.xml:4456 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:4466 +#: reference_raster.xml:4469 #, no-c-format msgid "ST_Reskew" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4467 +#: reference_raster.xml:4470 #, no-c-format msgid "Resample a raster by adjusting only its skew (or rotation parameters). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. Default is NearestNeighbor." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4472 +#: reference_raster.xml:4475 #, no-c-format msgid " raster ST_Reskew raster rast double precision skewxy text algorithm=NearestNeighbour double precision maxerr=0.125 raster ST_Reskew raster rast double precision skewx double precision skewy text algorithm=NearestNeighbour double precision maxerr=0.125 " msgstr "" #. Tag: para -#: reference_raster.xml:4496 +#: reference_raster.xml:4499 #, no-c-format msgid "Resample a raster by adjusting only its skew (or rotation parameters). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. The default is NearestNeighbor which is the fastest but results in the worst interpolation." msgstr "" #. Tag: para -#: reference_raster.xml:4498 +#: reference_raster.xml:4501 #, no-c-format msgid "skewx and skewy define the new skew." msgstr "" #. Tag: para -#: reference_raster.xml:4500 reference_raster.xml:4578 +#: reference_raster.xml:4503 reference_raster.xml:4581 #, no-c-format msgid "The extent of the new raster will encompass the extent of the provided raster." msgstr "" #. Tag: para -#: reference_raster.xml:4502 reference_raster.xml:4580 +#: reference_raster.xml:4505 reference_raster.xml:4583 #, no-c-format msgid "A maxerror percent of 0.125 if no maxerr is specified." msgstr "" #. Tag: para -#: reference_raster.xml:4506 +#: reference_raster.xml:4509 #, no-c-format msgid "ST_Reskew is different from in that ST_SetSkew do not resample the raster to match the raster extent. ST_SetSkew only changes the metadata (or georeference) of the raster to correct an originally mis-specified skew. ST_Reskew results in a raster having different width and height computed to fit the geographic extent of the input raster. ST_SetSkew do not modify the width, nor the height of the raster." msgstr "" #. Tag: para -#: reference_raster.xml:4514 +#: reference_raster.xml:4517 #, 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:4516 +#: reference_raster.xml:4519 #, no-c-format msgid "" "-- the original raster pixel size\n" @@ -5734,61 +5782,61 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4522 +#: reference_raster.xml:4525 #, no-c-format msgid ", , , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:4528 +#: reference_raster.xml:4531 #, no-c-format msgid "ST_SnapToGrid" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4529 +#: reference_raster.xml:4532 #, no-c-format msgid "Resample a raster by snapping it to a grid. New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. Default is NearestNeighbor." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4534 +#: reference_raster.xml:4537 #, no-c-format msgid " raster ST_SnapToGrid raster rast double precision gridx double precision gridy text algorithm=NearestNeighbour double precision maxerr=0.125 double precision scalex=DEFAULT 0 double precision scaley=DEFAULT 0 raster ST_SnapToGrid raster rast double precision gridx double precision gridy double precision scalex double precision scaley text algorithm=NearestNeighbour double precision maxerr=0.125 raster ST_SnapToGrid raster rast double precision gridx double precision gridy double precision scalexy text algorithm=NearestNeighbour double precision maxerr=0.125 " msgstr "" #. Tag: para -#: reference_raster.xml:4573 +#: reference_raster.xml:4576 #, no-c-format msgid "Resample a raster by snapping it to a grid defined by an arbitrary pixel corner (gridx & gridy) and optionally a pixel size (scalex & scaley). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. The default is NearestNeighbor which is the fastest but results in the worst interpolation." msgstr "" #. Tag: para -#: reference_raster.xml:4575 +#: reference_raster.xml:4578 #, no-c-format msgid "gridx and gridy define any arbitrary pixel corner of the new grid. This is not necessarily the upper left corner of the new raster and it does not have to be inside or on the edge of the new raster extent." msgstr "" #. Tag: para -#: reference_raster.xml:4577 +#: reference_raster.xml:4580 #, no-c-format msgid "You can optionnal define the pixel size of the new grid with scalex and scaley." msgstr "" #. Tag: para -#: reference_raster.xml:4584 +#: reference_raster.xml:4587 #, no-c-format msgid "Use if you need more control over the grid parameters." msgstr "" #. Tag: para -#: reference_raster.xml:4592 +#: reference_raster.xml:4595 #, no-c-format msgid "A simple example snapping a raster to a slightly different grid." msgstr "" #. Tag: programlisting -#: reference_raster.xml:4594 +#: reference_raster.xml:4597 #, no-c-format msgid "" "-- the original raster pixel size\n" @@ -5799,67 +5847,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4600 +#: reference_raster.xml:4603 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_raster.xml:4606 +#: reference_raster.xml:4609 #, no-c-format msgid "ST_Resize" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4607 +#: reference_raster.xml:4610 #, no-c-format msgid "Resize a raster to a new width/height" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4611 +#: reference_raster.xml:4614 #, no-c-format msgid " raster ST_Resize raster rast integer width integer height text algorithm=NearestNeighbor double precision maxerr=0.125 raster ST_Resize raster rast double precision percentwidth double precision percentheight text algorithm=NearestNeighbor double precision maxerr=0.125 raster ST_Resize raster rast text width text height text algorithm=NearestNeighbor double precision maxerr=0.125 " msgstr "" #. Tag: para -#: reference_raster.xml:4645 +#: reference_raster.xml:4648 #, no-c-format msgid "Resize a raster to a new width/height. The new width/height can be specified in exact number of pixels or a percentage of the raster's width/height. The extent of the the new raster will be the same as the extent of the provided raster." msgstr "" #. Tag: para -#: reference_raster.xml:4649 +#: reference_raster.xml:4652 #, no-c-format msgid "New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. The default is NearestNeighbor which is the fastest but results in the worst interpolation." msgstr "" #. Tag: para -#: reference_raster.xml:4653 +#: reference_raster.xml:4656 #, no-c-format msgid "Variant 1 expects the actual width/height of the output raster." msgstr "" #. Tag: para -#: reference_raster.xml:4657 +#: reference_raster.xml:4660 #, no-c-format msgid "Variant 2 expects decimal values between zero (0) and one (1) indicating the percentage of the input raster's width/height." msgstr "" #. Tag: para -#: reference_raster.xml:4661 +#: reference_raster.xml:4664 #, no-c-format msgid "Variant 3 takes either the actual width/height of the output raster or a textual percentage (\"20%\") indicating the percentage of the input raster's width/height." msgstr "" #. Tag: para -#: reference_raster.xml:4665 +#: reference_raster.xml:4668 #, no-c-format msgid "Availability: 2.1.0 Requires GDAL 1.6.1+" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4669 +#: reference_raster.xml:4672 #, no-c-format msgid "" "WITH foo AS(\n" @@ -5903,61 +5951,61 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4674 +#: reference_raster.xml:4677 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_raster.xml:4685 +#: reference_raster.xml:4688 #, no-c-format msgid "ST_Transform" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4686 +#: reference_raster.xml:4689 #, no-c-format msgid "Reprojects a raster in a known spatial reference system to another known spatial reference system using specified resampling algorithm. Options are NearestNeighbor, Bilinear, Cubic, CubicSpline, Lanczos defaulting to NearestNeighbor." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4690 +#: reference_raster.xml:4693 #, no-c-format msgid " raster ST_Transform raster rast integer srid text algorithm=NearestNeighbor double precision maxerr=0.125 double precision scalex double precision scaley raster ST_Transform raster rast integer srid double precision scalex double precision scaley text algorithm=NearestNeighbor double precision maxerr=0.125 raster ST_Transform raster rast raster alignto text algorithm=NearestNeighbor double precision maxerr=0.125 " msgstr "" #. Tag: para -#: reference_raster.xml:4724 +#: reference_raster.xml:4727 #, no-c-format msgid "Reprojects a raster in a known spatial reference system to another known spatial reference system using specified pixel warping algorithm. Uses 'NearestNeighbor' if no algorithm is specified and maxerror percent of 0.125 if no maxerr is specified." msgstr "" #. Tag: para -#: reference_raster.xml:4728 +#: reference_raster.xml:4731 #, no-c-format msgid "ST_Transform is often confused with ST_SetSRID(). ST_Transform actually changes the coordinates of a raster (and resamples the pixel values) from one spatial reference system to another, while ST_SetSRID() simply changes the SRID identifier of the raster." msgstr "" #. Tag: para -#: reference_raster.xml:4732 +#: reference_raster.xml:4735 #, no-c-format msgid "Unlike the other variants, Variant 3 requires a reference raster as alignto. The transformed raster will be transformed to the spatial reference system (SRID) of the reference raster and be aligned (ST_SameAlignment = TRUE) to the reference raster." msgstr "" #. Tag: para -#: reference_raster.xml:4737 +#: reference_raster.xml:4740 #, no-c-format msgid "If you find your transformation support is not working right, you may need to set the environment variable PROJSO to the .so or .dll projection library your PostGIS is using. This just needs to have the name of the file. So for example on windows, you would in Control Panel -> System -> Environment Variables add a system variable called PROJSO and set it to libproj.dll (if you are using proj 4.6.1). You'll have to restart your PostgreSQL service/daemon after this change." msgstr "" #. Tag: para -#: reference_raster.xml:4743 +#: reference_raster.xml:4746 #, no-c-format msgid "Enhanced: 2.1.0 Addition of ST_Transform(rast, alignto) variant" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4749 +#: reference_raster.xml:4752 #, no-c-format msgid "" "SELECT ST_Width(mass_stm) As w_before, ST_Width(wgs_84) As w_after,\n" @@ -5976,31 +6024,31 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4759 +#: reference_raster.xml:4762 #, no-c-format msgid "original mass state plane meters (mass_stm)" msgstr "" #. Tag: para -#: reference_raster.xml:4768 +#: reference_raster.xml:4771 #, no-c-format msgid "After transform to wgs 84 long lat (wgs_84)" msgstr "" #. Tag: para -#: reference_raster.xml:4777 +#: reference_raster.xml:4780 #, no-c-format msgid "After transform to wgs 84 long lat with bilinear algorithm instead of NN default (wgs_84_bilin)" msgstr "" #. Tag: para -#: reference_raster.xml:4790 +#: reference_raster.xml:4793 #, no-c-format msgid "The following shows the difference between using ST_Transform(raster, srid) and ST_Transform(raster, alignto)" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4791 +#: reference_raster.xml:4794 #, no-c-format msgid "" "WITH foo AS (\n" @@ -6041,43 +6089,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4796 +#: reference_raster.xml:4799 #, no-c-format msgid ", " msgstr "" #. Tag: title -#: reference_raster.xml:4802 +#: reference_raster.xml:4805 #, no-c-format msgid "Raster Band Editors" msgstr "" #. Tag: refname -#: reference_raster.xml:4806 +#: reference_raster.xml:4809 #, no-c-format msgid "ST_SetBandNoDataValue" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4807 +#: reference_raster.xml:4810 #, no-c-format msgid "Sets the value for the given band that represents no data. Band 1 is assumed if no band is specified. To mark a band as having no nodata value, set the nodata value = NULL." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4811 +#: reference_raster.xml:4814 #, no-c-format msgid " raster ST_SetBandNoDataValue raster rast double precision nodatavalue raster ST_SetBandNoDataValue raster rast integer band double precision nodatavalue boolean forcechecking=false " msgstr "" #. Tag: para -#: reference_raster.xml:4832 +#: reference_raster.xml:4835 #, no-c-format msgid "Sets the value that represents no data for the band. Band 1 is assumed if not specified. This will affect results from , , and the ST_PixelAs...() functions." msgstr "" #. Tag: programlisting -#: reference_raster.xml:4838 +#: reference_raster.xml:4841 #, no-c-format msgid "" "-- change just first band no data value\n" @@ -6103,31 +6151,31 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:4850 +#: reference_raster.xml:4853 #, no-c-format msgid "ST_SetBandIsNoData" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4851 +#: reference_raster.xml:4854 #, no-c-format msgid "Sets the isnodata flag of the band to TRUE." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:4856 +#: reference_raster.xml:4859 #, no-c-format msgid "raster ST_SetBandIsNoData raster rast integer band=1" msgstr "" #. Tag: para -#: reference_raster.xml:4867 +#: reference_raster.xml:4870 #, no-c-format msgid "Sets the isnodata flag for the band to true. Band 1 is assumed if not specified. This function should be called only when the flag is considered dirty. That is, when the result calling is different using TRUE as last argument and without using it" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4879 +#: reference_raster.xml:4882 #, no-c-format msgid "" "-- Create dummy table with one raster column\n" @@ -6190,55 +6238,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4885 +#: reference_raster.xml:4888 #, no-c-format msgid ", , , " msgstr "" #. Tag: title -#: reference_raster.xml:4894 +#: reference_raster.xml:4897 #, no-c-format msgid "Raster Band Statistics and Analytics" msgstr "" #. Tag: refname -#: reference_raster.xml:4898 +#: reference_raster.xml:4901 #, no-c-format msgid "ST_Count" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4899 +#: reference_raster.xml:4902 #, no-c-format msgid "Returns the number of pixels in a given band of a raster or raster coverage. If no band is specified defaults to band 1. If exclude_nodata_value is set to true, will only count pixels that are not equal to the nodata value." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4903 +#: reference_raster.xml:4906 #, no-c-format msgid " bigint ST_Count raster rast integer nband=1 boolean exclude_nodata_value=true bigint ST_Count raster rast boolean exclude_nodata_value bigint ST_Count text rastertable text rastercolumn integer nband=1 boolean exclude_nodata_value=true bigint ST_Count text rastertable text rastercolumn boolean exclude_nodata_value " msgstr "" #. Tag: para -#: reference_raster.xml:4934 +#: reference_raster.xml:4937 #, no-c-format msgid "Returns the number of pixels in a given band of a raster or raster coverage. If no band is specified nband defaults to 1." msgstr "" #. Tag: para -#: reference_raster.xml:4935 +#: reference_raster.xml:4938 #, no-c-format msgid "If exclude_nodata_value is set to true, will only count pixels with value not equal to the nodata value of the raster. Set exclude_nodata_value to false to get count all pixels" msgstr "" #. Tag: para -#: reference_raster.xml:4939 +#: reference_raster.xml:4942 #, no-c-format msgid "The ST_Count(rastertable, rastercolumn, ...) variants are deprecated as of 2.2.0. Use instead." msgstr "" #. Tag: programlisting -#: reference_raster.xml:4949 +#: reference_raster.xml:4952 #, no-c-format msgid "" "--example will count all pixels not 249 and one will count all pixels. --\n" @@ -6252,49 +6300,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4954 reference_raster.xml:5015 +#: reference_raster.xml:4957 reference_raster.xml:5018 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:4964 +#: reference_raster.xml:4967 #, no-c-format msgid "ST_CountAgg" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4965 +#: reference_raster.xml:4968 #, no-c-format msgid "Aggregate. Returns the number of pixels in a given band of a set of rasters. If no band is specified defaults to band 1. If exclude_nodata_value is set to true, will only count pixels that are not equal to the NODATA value." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4971 +#: reference_raster.xml:4974 #, no-c-format msgid " bigint ST_CountAgg raster rast integer nband boolean exclude_nodata_value double precision sample_percent bigint ST_CountAgg raster rast integer nband boolean exclude_nodata_value bigint ST_CountAgg raster rast boolean exclude_nodata_value " msgstr "" #. Tag: para -#: reference_raster.xml:4999 +#: reference_raster.xml:5002 #, no-c-format msgid "Returns the number of pixels in a given band of a set of rasters. If no band is specified nband defaults to 1." msgstr "" #. Tag: para -#: reference_raster.xml:5000 +#: reference_raster.xml:5003 #, no-c-format msgid "If exclude_nodata_value is set to true, will only count pixels with value not equal to the NODATA value of the raster. Set exclude_nodata_value to false to get count all pixels" msgstr "" #. Tag: para -#: reference_raster.xml:5003 +#: reference_raster.xml:5006 #, no-c-format msgid "By default will sample all pixels. To get faster response, set sample_percent to value between zero (0) and one (1)" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5010 +#: reference_raster.xml:5013 #, no-c-format msgid "" "WITH foo AS (\n" @@ -6331,85 +6379,85 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:5025 +#: reference_raster.xml:5028 #, no-c-format msgid "ST_Histogram" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5026 +#: reference_raster.xml:5029 #, no-c-format msgid "Returns a set of record summarizing a raster or raster coverage data distribution separate bin ranges. Number of bins are autocomputed if not specified." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:5030 +#: reference_raster.xml:5033 #, no-c-format msgid " SETOF record ST_Histogram raster rast integer nband=1 boolean exclude_nodata_value=true integer bins=autocomputed double precision[] width=NULL boolean right=false SETOF record ST_Histogram raster rast integer nband integer bins double precision[] width=NULL boolean right=false SETOF record ST_Histogram raster rast integer nband boolean exclude_nodata_value integer bins boolean right SETOF record ST_Histogram raster rast integer nband integer bins boolean right SETOF record ST_Histogram text rastertable text rastercolumn integer nband integer bins boolean right SETOF record ST_Histogram text rastertable text rastercolumn integer nband boolean exclude_nodata_value integer bins boolean right SETOF record ST_Histogram text rastertable text rastercolumn integer nband=1 boolean exclude_nodata_value=true integer bins=autocomputed double precision[] width=NULL boolean right=false SETOF record ST_Histogram text rastertable text rastercolumn integer nband=1 integer bins double precision[] width=NULL boolean right=false " msgstr "" #. Tag: para -#: reference_raster.xml:5112 +#: reference_raster.xml:5115 #, no-c-format msgid "Returns set of records consisting of min, max, count, percent for a given raster band for each bin. If no band is specified nband defaults to 1." msgstr "" #. Tag: para -#: reference_raster.xml:5113 +#: reference_raster.xml:5116 #, no-c-format msgid "By default only considers pixel values not equal to the nodata value . Set exclude_nodata_value to false to get count all pixels." msgstr "" #. Tag: term -#: reference_raster.xml:5117 +#: reference_raster.xml:5120 #, no-c-format msgid "width double precision[]" msgstr "" #. Tag: para -#: reference_raster.xml:5118 +#: reference_raster.xml:5121 #, no-c-format msgid "width: an array indicating the width of each category/bin. If the number of bins is greater than the number of widths, the widths are repeated." msgstr "" #. Tag: para -#: reference_raster.xml:5119 +#: reference_raster.xml:5122 #, no-c-format msgid "Example: 9 bins, widths are [a, b, c] will have the output be [a, b, c, a, b, c, a, b, c]" msgstr "" #. Tag: term -#: reference_raster.xml:5122 +#: reference_raster.xml:5125 #, no-c-format msgid "bins integer" msgstr "" #. Tag: para -#: reference_raster.xml:5123 +#: reference_raster.xml:5126 #, no-c-format msgid "Number of breakouts -- this is the number of records you'll get back from the function if specified. If not specified then the number of breakouts is autocomputed." msgstr "" #. Tag: term -#: reference_raster.xml:5127 +#: reference_raster.xml:5130 #, no-c-format msgid "right boolean" msgstr "" #. Tag: para -#: reference_raster.xml:5128 +#: reference_raster.xml:5131 #, no-c-format msgid "compute the histogram from the right rather than from the left (default). This changes the criteria for evaluating a value x from [a, b) to (a, b]" msgstr "" #. Tag: title -#: reference_raster.xml:5135 +#: reference_raster.xml:5138 #, no-c-format msgid "Example: Single raster tile - compute histograms for bands 1, 2, 3 and autocompute bins" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5136 +#: reference_raster.xml:5139 #, no-c-format msgid "" "SELECT band, (stats).*\n" @@ -6437,13 +6485,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:5140 +#: reference_raster.xml:5143 #, no-c-format msgid "Example: Just band 2 but for 6 bins" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5141 +#: reference_raster.xml:5144 #, no-c-format msgid "" "SELECT (stats).*\n" @@ -6479,43 +6527,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5146 +#: reference_raster.xml:5149 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:5156 +#: reference_raster.xml:5159 #, no-c-format msgid "ST_Quantile" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5157 +#: reference_raster.xml:5160 #, no-c-format msgid "Compute quantiles for a raster or raster table coverage in the context of the sample or population. Thus, a value could be examined to be at the raster's 25%, 50%, 75% percentile." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:5161 +#: reference_raster.xml:5164 #, no-c-format msgid " SETOF record ST_Quantile raster rast integer nband=1 boolean exclude_nodata_value=true double precision[] quantiles=NULL SETOF record ST_Quantile raster rast double precision[] quantiles SETOF record ST_Quantile raster rast integer nband double precision[] quantiles double precision ST_Quantile raster rast double precision quantile double precision ST_Quantile raster rast boolean exclude_nodata_value double precision quantile=NULL double precision ST_Quantile raster rast integer nband double precision quantile double precision ST_Quantile raster rast integer nband boolean exclude_nodata_value double precision quantile double precision ST_Quantile raster rast integer nband double precision quantile SETOF record ST_Quantile text rastertable text rastercolumn integer nband=1 boolean exclude_nodata_value=true double precision[] quantiles=NULL SETOF record ST_Quantile text rastertable text rastercolumn integer nband double precision[] quantiles " msgstr "" #. Tag: para -#: reference_raster.xml:5233 +#: reference_raster.xml:5236 #, no-c-format msgid "Compute quantiles for a raster or raster table coverage in the context of the sample or population. Thus, a value could be examined to be at the raster's 25%, 50%, 75% percentile." msgstr "" #. Tag: para -#: reference_raster.xml:5234 reference_raster.xml:5526 +#: reference_raster.xml:5237 reference_raster.xml:5529 #, no-c-format msgid "If exclude_nodata_value is set to false, will also count pixels with no data." msgstr "" #. Tag: programlisting -#: reference_raster.xml:5241 +#: reference_raster.xml:5244 #, no-c-format msgid "" "UPDATE dummy_rast SET rast = ST_SetBandNoDataValue(rast,249) WHERE rid=2;\n" @@ -6540,7 +6588,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5242 +#: reference_raster.xml:5245 #, no-c-format msgid "" "--real live example. Quantile of all pixels in band 2 intersecting a geometry\n" @@ -6578,61 +6626,61 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5247 +#: reference_raster.xml:5250 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_raster.xml:5258 +#: reference_raster.xml:5261 #, no-c-format msgid "ST_SummaryStats" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5259 +#: reference_raster.xml:5262 #, no-c-format msgid "Returns summarystats consisting of count, sum, mean, stddev, min, max for a given raster band of a raster or raster coverage. Band 1 is assumed is no band is specified." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:5263 +#: reference_raster.xml:5266 #, no-c-format msgid " summarystats ST_SummaryStats raster rast boolean exclude_nodata_value summarystats ST_SummaryStats raster rast integer nband boolean exclude_nodata_value summarystats ST_SummaryStats text rastertable text rastercolumn boolean exclude_nodata_value summarystats ST_SummaryStats text rastertable text rastercolumn integer nband=1 boolean exclude_nodata_value=true " msgstr "" #. Tag: para -#: reference_raster.xml:5299 reference_raster.xml:5378 +#: reference_raster.xml:5302 reference_raster.xml:5381 #, no-c-format msgid "Returns consisting of count, sum, mean, stddev, min, max for a given raster band of a raster or raster coverage. If no band is specified nband defaults to 1." msgstr "" #. Tag: para -#: reference_raster.xml:5301 +#: reference_raster.xml:5304 #, no-c-format msgid "By default only considers pixel values not equal to the nodata value. Set exclude_nodata_value to false to get count of all pixels." msgstr "" #. Tag: para -#: reference_raster.xml:5303 +#: reference_raster.xml:5306 #, no-c-format msgid "By default will sample all pixels. To get faster response, set sample_percent to lower than 1" msgstr "" #. Tag: para -#: reference_raster.xml:5308 +#: reference_raster.xml:5311 #, no-c-format msgid "The ST_SummaryStats(rastertable, rastercolumn, ...) variants are deprecated as of 2.2.0. Use instead." msgstr "" #. Tag: title -#: reference_raster.xml:5316 +#: reference_raster.xml:5319 #, no-c-format msgid "Example: Single raster tile" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5317 +#: reference_raster.xml:5320 #, no-c-format msgid "" "SELECT rid, band, (stats).*\n" @@ -6648,19 +6696,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:5321 +#: reference_raster.xml:5324 #, no-c-format msgid "Example: Summarize pixels that intersect buildings of interest" msgstr "" #. Tag: para -#: reference_raster.xml:5322 +#: reference_raster.xml:5325 #, no-c-format msgid "This example took 574ms on PostGIS windows 64-bit with all of Boston Buildings and aerial Tiles (tiles each 150x150 pixels ~ 134,000 tiles), ~102,000 building records" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5324 +#: reference_raster.xml:5327 #, no-c-format msgid "" "WITH \n" @@ -6695,13 +6743,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:5328 +#: reference_raster.xml:5331 #, no-c-format msgid "Example: Raster coverage" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5329 +#: reference_raster.xml:5332 #, no-c-format msgid "" "-- stats for each band --\n" @@ -6729,43 +6777,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5334 +#: reference_raster.xml:5337 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_raster.xml:5345 +#: reference_raster.xml:5348 #, no-c-format msgid "ST_SummaryStatsAgg" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5346 +#: reference_raster.xml:5349 #, no-c-format msgid "Aggregate. Returns summarystats consisting of count, sum, mean, stddev, min, max for a given raster band of a set of raster. Band 1 is assumed is no band is specified." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:5350 +#: reference_raster.xml:5353 #, no-c-format msgid " summarystats ST_SummaryStatsAgg raster rast integer nband boolean exclude_nodata_value double precision sample_percent summarystats ST_SummaryStatsAgg raster rast boolean exclude_nodata_value double precision sample_percent summarystats ST_SummaryStatsAgg raster rast integer nband boolean exclude_nodata_value " msgstr "" #. Tag: para -#: reference_raster.xml:5380 +#: reference_raster.xml:5383 #, no-c-format msgid "By default only considers pixel values not equal to the NODATA value. Set exclude_nodata_value to False to get count of all pixels." msgstr "" #. Tag: para -#: reference_raster.xml:5382 +#: reference_raster.xml:5385 #, no-c-format msgid "By default will sample all pixels. To get faster response, set sample_percent to value between 0 and 1" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5389 +#: reference_raster.xml:5392 #, no-c-format msgid "" "WITH foo AS (\n" @@ -6811,43 +6859,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5394 +#: reference_raster.xml:5397 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_raster.xml:5405 +#: reference_raster.xml:5408 #, no-c-format msgid "ST_ValueCount" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5406 +#: reference_raster.xml:5409 #, no-c-format msgid "Returns a set of records containing a pixel band value and count of the number of pixels in a given band of a raster (or a raster coverage) that have a given set of values. If no band is specified defaults to band 1. By default nodata value pixels are not counted. and all other values in the pixel are output and pixel band values are rounded to the nearest integer." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:5411 +#: reference_raster.xml:5414 #, no-c-format msgid " SETOF record ST_ValueCount raster rast integer nband=1 boolean exclude_nodata_value=true double precision[] searchvalues=NULL double precision roundto=0 double precision OUT value integer OUT count SETOF record ST_ValueCount raster rast integer nband double precision[] searchvalues double precision roundto=0 double precision OUT value integer OUT count SETOF record ST_ValueCount raster rast double precision[] searchvalues double precision roundto=0 double precision OUT value integer OUT count bigint ST_ValueCount raster rast double precision searchvalue double precision roundto=0 bigint ST_ValueCount raster rast integer nband boolean exclude_nodata_value double precision searchvalue double precision roundto=0 bigint ST_ValueCount raster rast integer nband double precision searchvalue double precision roundto=0 SETOF record ST_ValueCount text rastertable text rastercolumn integer nband=1 boolean exclude_nodata_value=true double precision[] searchvalues=NULL double precision roundto=0 double precision OUT value integer OUT count SETOF record ST_ValueCount text rastertable text rastercolumn double precision[] searchvalues double precision roundto=0 double precision OUT value integer OUT count SETOF record ST_ValueCount text rastertable text rastercolumn integer nband double precision[] searchvalues double precision roundto=0 double precision OUT value integer OUT count bigintST_ValueCount text rastertable text rastercolumn integer nband boolean exclude_nodata_value double precision searchvalue double precision roundto=0 bigint ST_ValueCount text rastertable text rastercolumn double precision searchvalue double precision roundto=0 bigint ST_ValueCount text rastertable text rastercolumn integer nband double precision searchvalue double precision roundto=0 " msgstr "" #. Tag: para -#: reference_raster.xml:5524 +#: reference_raster.xml:5527 #, no-c-format msgid "Returns a set of records with columns value count which contain the pixel band value and count of pixels in the raster tile or raster coverage of selected band." msgstr "" #. Tag: para -#: reference_raster.xml:5525 +#: reference_raster.xml:5528 #, no-c-format msgid "If no band is specified nband defaults to 1. If no searchvalues are specified, will return all pixel values found in the raster or raster coverage. If one searchvalue is given, will return an integer instead of records denoting the count of pixels having that pixel band value" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5533 +#: reference_raster.xml:5536 #, no-c-format msgid "" "UPDATE dummy_rast SET rast = ST_SetBandNoDataValue(rast,249) WHERE rid=2;\n" @@ -6901,7 +6949,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5534 +#: reference_raster.xml:5537 #, no-c-format msgid "" "--real live example. Count all the pixels in an aerial raster tile band 2 intersecting a geometry \n" @@ -6924,7 +6972,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5536 +#: reference_raster.xml:5539 #, no-c-format msgid "" "-- Just return count of pixels in each raster tile that have value of 100 of tiles that intersect a specific geometry --\n" @@ -6943,61 +6991,61 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5541 +#: reference_raster.xml:5544 #, no-c-format msgid ", " msgstr "" #. Tag: title -#: reference_raster.xml:5547 +#: reference_raster.xml:5550 #, no-c-format msgid "Raster Outputs" msgstr "" #. Tag: refname -#: reference_raster.xml:5550 +#: reference_raster.xml:5553 #, no-c-format msgid "ST_AsBinary" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5551 +#: reference_raster.xml:5554 #, no-c-format msgid "Return the Well-Known Binary (WKB) representation of the raster without SRID meta data." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:5556 +#: reference_raster.xml:5559 #, no-c-format msgid "bytea ST_AsBinary raster rast boolean outasin=FALSE" msgstr "" #. Tag: para -#: reference_raster.xml:5567 +#: reference_raster.xml:5570 #, no-c-format msgid "Returns the Binary representation of the raster. If outasin is TRUE, out-db bands are treated as in-db." msgstr "" #. Tag: para -#: reference_raster.xml:5571 +#: reference_raster.xml:5574 #, no-c-format msgid "This is useful in binary cursors to pull data out of the database without converting it to a string representation." msgstr "" #. Tag: para -#: reference_raster.xml:5576 +#: reference_raster.xml:5579 #, no-c-format msgid "By default, WKB output contains the external file path for out-db bands. If the client does not have access to the raster file underlying an out-db band, set outasin to TRUE." msgstr "" #. Tag: para -#: reference_raster.xml:5580 +#: reference_raster.xml:5583 #, no-c-format msgid "Enhanced: 2.1.0 Addition of outasin" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5586 +#: reference_raster.xml:5589 #, no-c-format msgid "" "SELECT ST_AsBinary(rast) As rastbin FROM dummy_rast WHERE rid=1;\n" @@ -7010,55 +7058,55 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:5593 +#: reference_raster.xml:5596 #, no-c-format msgid "ST_AsGDALRaster" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5594 +#: reference_raster.xml:5597 #, no-c-format msgid "Return the raster tile in the designated GDAL Raster format. Raster formats are one of those supported by your compiled library. Use ST_GDALRasters() to get a list of formats supported by your library." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:5599 +#: reference_raster.xml:5602 #, no-c-format msgid "bytea ST_AsGDALRaster raster rast text format text[] options=NULL integer srid=sameassource" msgstr "" #. Tag: para -#: reference_raster.xml:5613 +#: reference_raster.xml:5616 #, no-c-format msgid "Returns the raster tile in the designated format. Arguments are itemized below:" msgstr "" #. Tag: para -#: reference_raster.xml:5616 +#: reference_raster.xml:5619 #, no-c-format msgid "format format to output. This is dependent on the drivers compiled in your libgdal library. Generally available are 'JPEG', 'GTIff', 'PNG'. Use to get a list of formats supported by your library." msgstr "" #. Tag: para -#: reference_raster.xml:5621 +#: reference_raster.xml:5624 #, no-c-format msgid "options text array of GDAL options. Valid options are dependent on the format. Refer to GDAL Raster format options for more details." msgstr "" #. Tag: para -#: reference_raster.xml:5626 +#: reference_raster.xml:5629 #, no-c-format msgid "srs The proj4text or srtext (from spatial_ref_sys) to embed in the image" msgstr "" #. Tag: title -#: reference_raster.xml:5635 +#: reference_raster.xml:5638 #, no-c-format msgid "JPEG Output Examples" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5637 +#: reference_raster.xml:5640 #, no-c-format msgid "" "SELECT ST_AsGDALRaster(rast, 'JPEG') As rastjpg\n" @@ -7069,13 +7117,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:5642 +#: reference_raster.xml:5645 #, no-c-format msgid "GTIFF Output Examples" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5644 +#: reference_raster.xml:5647 #, no-c-format msgid "" "SELECT ST_AsGDALRaster(rast, 'GTiff') As rastjpg\n" @@ -7089,67 +7137,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5651 +#: reference_raster.xml:5654 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:5657 +#: reference_raster.xml:5660 #, no-c-format msgid "ST_AsJPEG" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5658 +#: reference_raster.xml:5661 #, no-c-format msgid "Return the raster tile selected bands as a single Joint Photographic Exports Group (JPEG) image (byte array). If no band is specified and 1 or more than 3 bands, then only the first band is used. If only 3 bands then all 3 bands are used and mapped to RGB." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:5662 +#: reference_raster.xml:5665 #, no-c-format msgid " bytea ST_AsJPEG raster rast text[] options=NULL bytea ST_AsJPEG raster rast integer nband integer quality bytea ST_AsJPEG raster rast integer nband text[] options=NULL bytea ST_AsJPEG raster rast integer[] nbands text[] options=NULL bytea ST_AsJPEG raster rast integer[] nbands integer quality " msgstr "" #. Tag: para -#: reference_raster.xml:5698 +#: reference_raster.xml:5701 #, no-c-format msgid "Returns the selected bands of the raster as a single Joint Photographic Exports Group Image (JPEG). Use if you need to export as less common raster types. If no band is specified and 1 or more than 3 bands, then only the first band is used. If 3 bands then all 3 bands are used. There are many variants of the function with many options. These are itemized below:" msgstr "" #. Tag: para -#: reference_raster.xml:5701 reference_raster.xml:5792 +#: reference_raster.xml:5704 reference_raster.xml:5795 #, no-c-format msgid "nband is for single band exports." msgstr "" #. Tag: para -#: reference_raster.xml:5706 +#: reference_raster.xml:5709 #, no-c-format msgid "nbands is an array of bands to export (note that max is 3 for JPEG) and the order of the bands is RGB. e.g ARRAY[3,2,1] means map band 3 to Red, band 2 to green and band 1 to blue" msgstr "" #. Tag: para -#: reference_raster.xml:5711 +#: reference_raster.xml:5714 #, no-c-format msgid "quality number from 0 to 100. The higher the number the crisper the image." msgstr "" #. Tag: para -#: reference_raster.xml:5716 +#: reference_raster.xml:5719 #, no-c-format msgid "options text Array of GDAL options as defined for JPEG (look at create_options for JPEG ). For JPEG valid ones are PROGRESSIVE ON or OFF and QUALITY a range from 0 to 100 and default to 75. Refer to GDAL Raster format options for more details." msgstr "" #. Tag: title -#: reference_raster.xml:5733 +#: reference_raster.xml:5736 #, no-c-format msgid "Examples: Output" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5735 +#: reference_raster.xml:5738 #, no-c-format msgid "" "-- output first 3 bands 75% quality\n" @@ -7166,55 +7214,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5742 +#: reference_raster.xml:5745 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:5748 +#: reference_raster.xml:5751 #, no-c-format msgid "ST_AsPNG" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5749 +#: reference_raster.xml:5752 #, no-c-format msgid "Return the raster tile selected bands as a single portable network graphics (PNG) image (byte array). If 1, 3, or 4 bands in raster and no bands are specified, then all bands are used. If more 2 or more than 4 bands and no bands specified, then only band 1 is used. Bands are mapped to RGB or RGBA space." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:5753 +#: reference_raster.xml:5756 #, no-c-format msgid " bytea ST_AsPNG raster rast text[] options=NULL bytea ST_AsPNG raster rast integer nband integer compression bytea ST_AsPNG raster rast integer nband text[] options=NULL bytea ST_AsPNG raster rast integer[] nbands integer compression bytea ST_AsPNG raster rast integer[] nbands text[] options=NULL " msgstr "" #. Tag: para -#: reference_raster.xml:5789 +#: reference_raster.xml:5792 #, no-c-format msgid "Returns the selected bands of the raster as a single Portable Network Graphics Image (PNG). Use if you need to export as less common raster types. If no band is specified, then the first 3 bands are exported. There are many variants of the function with many options. If no srid is specified then then srid of the raster is used. These are itemized below:" msgstr "" #. Tag: para -#: reference_raster.xml:5797 reference_raster.xml:5880 +#: reference_raster.xml:5800 reference_raster.xml:5883 #, no-c-format msgid "nbands is an array of bands to export (note that max is 3 for PNG) and the order of the bands is RGB. e.g ARRAY[3,2,1] means map band 3 to Red, band 2 to green and band 1 to blue" msgstr "" #. Tag: para -#: reference_raster.xml:5802 +#: reference_raster.xml:5805 #, no-c-format msgid "compression number from 1 to 9. The higher the number the greater the compression." msgstr "" #. Tag: para -#: reference_raster.xml:5807 +#: reference_raster.xml:5810 #, no-c-format msgid "options text Array of GDAL options as defined for PNG (look at create_options for PNG of ). For PNG valid one is only ZLEVEL (amount of time to spend on compression -- default 6) e.g. ARRAY['ZLEVEL=9']. WORLDFILE is not allowed since the function would have to output two outputs. Refer to GDAL Raster format options for more details." msgstr "" #. Tag: programlisting -#: reference_raster.xml:5826 +#: reference_raster.xml:5829 #, no-c-format msgid "" "SELECT ST_AsPNG(rast) As rastpng\n" @@ -7226,61 +7274,61 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5833 +#: reference_raster.xml:5836 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_raster.xml:5839 +#: reference_raster.xml:5842 #, no-c-format msgid "ST_AsTIFF" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5840 +#: reference_raster.xml:5843 #, no-c-format msgid "Return the raster selected bands as a single TIFF image (byte array). If no band is specified, then will try to use all bands." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:5844 +#: reference_raster.xml:5847 #, no-c-format msgid " bytea ST_AsTIFF raster rast text[] options='' integer srid=sameassource bytea ST_AsTIFF raster rast text compression='' integer srid=sameassource bytea ST_AsTIFF raster rast integer[] nbands text compression='' integer srid=sameassource bytea ST_AsTIFF raster rast integer[] nbands text[] options integer srid=sameassource " msgstr "" #. Tag: para -#: reference_raster.xml:5877 +#: reference_raster.xml:5880 #, no-c-format msgid "Returns the selected bands of the raster as a single Tagged Image File Format (TIFF). If no band is specified, will try to use all bands. This is a wrapper around . Use if you need to export as less common raster types. There are many variants of the function with many options. If no spatial reference SRS text is present, the spatial reference of the raster is used. These are itemized below:" msgstr "" #. Tag: para -#: reference_raster.xml:5885 +#: reference_raster.xml:5888 #, no-c-format msgid "compression Compression expression -- JPEG90 (or some other percent), LZW, JPEG, DEFLATE9." msgstr "" #. Tag: para -#: reference_raster.xml:5890 +#: reference_raster.xml:5893 #, no-c-format msgid "options text Array of GDAL create options as defined for GTiff (look at create_options for GTiff of ). or refer to GDAL Raster format options for more details." msgstr "" #. Tag: para -#: reference_raster.xml:5895 +#: reference_raster.xml:5898 #, no-c-format msgid "srid srid of spatial_ref_sys of the raster. This is used to populate the georeference information" msgstr "" #. Tag: title -#: reference_raster.xml:5904 +#: reference_raster.xml:5907 #, no-c-format msgid "Examples: Use jpeg compression 90%" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5906 +#: reference_raster.xml:5909 #, no-c-format msgid "" "SELECT ST_AsTIFF(rast, 'JPEG90') As rasttiff\n" @@ -7288,79 +7336,79 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5913 +#: reference_raster.xml:5916 #, no-c-format msgid ", , " msgstr "" #. Tag: title -#: reference_raster.xml:5919 +#: reference_raster.xml:5922 #, no-c-format msgid "Raster Processing" msgstr "" #. Tag: title -#: reference_raster.xml:5922 +#: reference_raster.xml:5925 #, no-c-format msgid "Map Algebra" msgstr "" #. Tag: refname -#: reference_raster.xml:5926 +#: reference_raster.xml:5929 #, no-c-format msgid "ST_Clip" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5927 +#: reference_raster.xml:5930 #, no-c-format msgid "Returns the raster clipped by the input geometry. If band number not is specified, all bands are processed. If crop is not specified or TRUE, the output raster is cropped." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:5931 +#: reference_raster.xml:5934 #, no-c-format msgid " raster ST_Clip raster rast integer[] nband geometry geom double precision[] nodataval=NULL boolean crop=TRUE raster ST_Clip raster rast integer nband geometry geom double precision nodataval boolean crop=TRUE raster ST_Clip raster rast integer nband geometry geom boolean crop raster ST_Clip raster rast geometry geom double precision[] nodataval=NULL boolean crop=TRUE raster ST_Clip raster rast geometry geom double precision nodataval boolean crop=TRUE raster ST_Clip raster rast geometry geom boolean crop " msgstr "" #. Tag: para -#: reference_raster.xml:5988 +#: reference_raster.xml:5991 #, no-c-format msgid "Returns a raster that is clipped by the input geometry geom. If band index is not specified, all bands are processed." msgstr "" #. Tag: para -#: reference_raster.xml:5992 +#: reference_raster.xml:5995 #, no-c-format msgid "Rasters resulting from ST_Clip must have a nodata value assigned for areas clipped, one for each band. If none are provided and the input raster do not have a nodata value defined, nodata values of the resulting raster are set to ST_MinPossibleValue(ST_BandPixelType(rast, band)). When the number of nodata value in the array is smaller than the number of band, the last one in the array is used for the remaining bands. If the number of nodata value is greater than the number of band, the extra nodata values are ignored. All variants accepting an array of nodata values also accept a single value which will be assigned to each band." msgstr "" #. Tag: para -#: reference_raster.xml:5996 +#: reference_raster.xml:5999 #, no-c-format msgid "If crop is not specified, true is assumed meaning the output raster is cropped to the intersection of the geomand rast extents. If crop is set to false, the new raster gets the same extent as rast." msgstr "" #. Tag: para -#: reference_raster.xml:6002 +#: reference_raster.xml:6005 #, no-c-format msgid "Enhanced: 2.1.0 Rewritten in C" msgstr "" #. Tag: para -#: reference_raster.xml:6004 +#: reference_raster.xml:6007 #, no-c-format msgid "Examples here use Massachusetts aerial data available on MassGIS site MassGIS Aerial Orthos. Coordinates are in Massachusetts State Plane Meters." msgstr "" #. Tag: title -#: reference_raster.xml:6010 +#: reference_raster.xml:6013 #, no-c-format msgid "Examples: 1 band clipping" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6012 +#: reference_raster.xml:6015 #, no-c-format msgid "" "-- Clip the first band of an aerial tile by a 20 meter buffer.\n" @@ -7371,7 +7419,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6014 +#: reference_raster.xml:6017 #, no-c-format msgid "" "-- Demonstrate effect of crop on final dimensions of raster\n" @@ -7391,25 +7439,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6028 reference_raster.xml:6071 reference_raster.xml:6114 +#: reference_raster.xml:6031 reference_raster.xml:6074 reference_raster.xml:6117 #, no-c-format msgid "Full raster tile before clipping" msgstr "" #. Tag: para -#: reference_raster.xml:6042 reference_raster.xml:6128 +#: reference_raster.xml:6045 reference_raster.xml:6131 #, no-c-format msgid "After Clipping" msgstr "" #. Tag: title -#: reference_raster.xml:6055 +#: reference_raster.xml:6058 #, no-c-format msgid "Examples: 1 band clipping with no crop and add back other bands unchanged" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6057 +#: reference_raster.xml:6060 #, no-c-format msgid "" "-- Same example as before, but we need to set crop to false to be able to use ST_AddBand\n" @@ -7421,19 +7469,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6085 +#: reference_raster.xml:6088 #, no-c-format msgid "After Clipping - surreal" msgstr "" #. Tag: title -#: reference_raster.xml:6098 +#: reference_raster.xml:6101 #, no-c-format msgid "Examples: Clip all bands" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6100 +#: reference_raster.xml:6103 #, no-c-format msgid "" "-- Clip all bands of an aerial tile by a 20 meter buffer.\n" @@ -7447,91 +7495,91 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6143 +#: reference_raster.xml:6146 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:6153 +#: reference_raster.xml:6156 #, no-c-format msgid "ST_ColorMap" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:6154 +#: reference_raster.xml:6157 #, no-c-format msgid "Creates a new raster of up to four 8BUI bands (grayscale, RGB, RGBA) from the source raster and a specified band. Band 1 is assumed if not specified." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:6159 +#: reference_raster.xml:6162 #, no-c-format msgid "raster ST_ColorMap raster rast integer nband=1 text colormap=grayscale text method=INTERPOLATE" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:6169 +#: reference_raster.xml:6172 #, no-c-format msgid "raster ST_ColorMap raster rast text colormap text method=INTERPOLATE" msgstr "" #. Tag: para -#: reference_raster.xml:6181 +#: reference_raster.xml:6184 #, no-c-format msgid "Apply a colormap to the band at nband of rast resulting a new raster comprised of up to four 8BUI bands. The number of 8BUI bands in the new raster is determined by the number of color components defined in colormap." msgstr "" #. Tag: para -#: reference_raster.xml:6185 +#: reference_raster.xml:6188 #, no-c-format msgid "If nband is not specified, then band 1 is assumed." msgstr "" #. Tag: para -#: reference_raster.xml:6187 +#: reference_raster.xml:6190 #, no-c-format msgid "colormap can be a keyword of a pre-defined colormap or a set of lines defining the value and the color components." msgstr "" #. Tag: para -#: reference_raster.xml:6191 +#: reference_raster.xml:6194 #, no-c-format msgid "Valid pre-defined colormap keyword:" msgstr "" #. Tag: para -#: reference_raster.xml:6197 +#: reference_raster.xml:6200 #, no-c-format msgid "grayscale or greyscale for a one 8BUI band raster of shades of gray." msgstr "" #. Tag: para -#: reference_raster.xml:6202 +#: reference_raster.xml:6205 #, no-c-format msgid "pseudocolor for a four 8BUI (RGBA) band raster with colors going from blue to green to red." msgstr "" #. Tag: para -#: reference_raster.xml:6207 +#: reference_raster.xml:6210 #, no-c-format msgid "fire for a four 8BUI (RGBA) band raster with colors going from black to red to pale yellow." msgstr "" #. Tag: para -#: reference_raster.xml:6212 +#: reference_raster.xml:6215 #, no-c-format msgid "bluered for a four 8BUI (RGBA) band raster with colors going from blue to pale white to red." msgstr "" #. Tag: para -#: reference_raster.xml:6218 +#: reference_raster.xml:6221 #, no-c-format msgid "Users can pass a set of entries (one per line) to colormap to specify custom colormaps. Each entry generally consists of five values: the pixel value and corresponding Red, Green, Blue, Alpha components (color components between 0 and 255). Percent values can be used instead of pixel values where 0% and 100% are the minimum and maximum values found in the raster band. Values can be separated with commas (','), tabs, colons (':') and/or spaces. The pixel value can be set to nv, null or nodata for the NODATA value. An example is provided below." msgstr "" #. Tag: programlisting -#: reference_raster.xml:6222 +#: reference_raster.xml:6225 #, no-c-format msgid "" "5 0 0 0 255\n" @@ -7542,55 +7590,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6224 +#: reference_raster.xml:6227 #, no-c-format msgid "The syntax of colormap is similar to that of the color-relief mode of GDAL gdaldem." msgstr "" #. Tag: para -#: reference_raster.xml:6228 +#: reference_raster.xml:6231 #, no-c-format msgid "Valid keywords for method:" msgstr "" #. Tag: para -#: reference_raster.xml:6234 +#: reference_raster.xml:6237 #, no-c-format msgid "INTERPOLATE to use linear interpolation to smoothly blend the colors between the given pixel values" msgstr "" #. Tag: para -#: reference_raster.xml:6239 +#: reference_raster.xml:6242 #, no-c-format msgid "EXACT to strictly match only those pixels values found in the colormap. Pixels whose value does not match a colormap entry will be set to 0 0 0 0 (RGBA)" msgstr "" #. Tag: para -#: reference_raster.xml:6244 +#: reference_raster.xml:6247 #, no-c-format msgid "NEAREST to use the colormap entry whose value is closest to the pixel value" msgstr "" #. Tag: para -#: reference_raster.xml:6251 +#: reference_raster.xml:6254 #, no-c-format msgid "A great reference for colormaps is ColorBrewer." msgstr "" #. Tag: para -#: reference_raster.xml:6256 +#: reference_raster.xml:6259 #, no-c-format msgid "The resulting bands of new raster will have no NODATA value set. Use to set a NODATA value if one is needed." msgstr "" #. Tag: para -#: reference_raster.xml:6266 +#: reference_raster.xml:6269 #, no-c-format msgid "This is a junk table to play with" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6268 +#: reference_raster.xml:6271 #, no-c-format msgid "" "-- setup test raster table --\n" @@ -7621,7 +7669,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6270 +#: reference_raster.xml:6273 #, no-c-format msgid "" "SELECT\n" @@ -7643,7 +7691,7 @@ msgid "" msgstr "" #. Tag: screen -#: reference_raster.xml:6272 +#: reference_raster.xml:6275 #, no-c-format msgid "" "n_orig | ngrey | npseudo | nfire | nbluered | nred\n" @@ -7652,13 +7700,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:6276 +#: reference_raster.xml:6279 #, no-c-format msgid "Examples: Compare different color map looks using ST_AsPNG" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6277 +#: reference_raster.xml:6280 #, no-c-format msgid "" "SELECT\n" @@ -7680,139 +7728,139 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6291 +#: reference_raster.xml:6294 #, no-c-format msgid "orig_png" msgstr "" #. Tag: para -#: reference_raster.xml:6305 +#: reference_raster.xml:6308 #, no-c-format msgid "grey_png" msgstr "" #. Tag: para -#: reference_raster.xml:6319 +#: reference_raster.xml:6322 #, no-c-format msgid "pseudo_png" msgstr "" #. Tag: para -#: reference_raster.xml:6335 +#: reference_raster.xml:6338 #, no-c-format msgid "fire_png" msgstr "" #. Tag: para -#: reference_raster.xml:6349 +#: reference_raster.xml:6352 #, no-c-format msgid "bluered_png" msgstr "" #. Tag: para -#: reference_raster.xml:6363 +#: reference_raster.xml:6366 #, no-c-format msgid "red_png" msgstr "" #. Tag: para -#: reference_raster.xml:6377 +#: reference_raster.xml:6380 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:6391 +#: reference_raster.xml:6394 #, no-c-format msgid "ST_Intersection" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:6392 +#: reference_raster.xml:6395 #, no-c-format msgid "Returns a raster or a set of geometry-pixelvalue pairs representing the shared portion of two rasters or the geometrical intersection of a vectorization of the raster and a geometry." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:6396 +#: reference_raster.xml:6399 #, no-c-format msgid " setof geomval ST_Intersection geometry geom raster rast integer band_num=1 setof geomval ST_Intersection raster rast geometry geom setof geomval ST_Intersection raster rast integer band_num geometry geom raster ST_Intersection raster rast1 raster rast2 double precision[] nodataval raster ST_Intersection raster rast1 raster rast2 text returnband='BOTH' double precision[] nodataval=NULL raster ST_Intersection raster rast1 integer band_num1 raster rast2 integer band_num2 double precision[] nodataval raster ST_Intersection raster rast1 integer band_num1 raster rast2 integer band_num2 text returnband='BOTH' double precision[] nodataval=NULL " msgstr "" #. Tag: para -#: reference_raster.xml:6456 +#: reference_raster.xml:6459 #, no-c-format msgid "Returns a raster or a set of geometry-pixelvalue pairs representing the shared portion of two rasters or the geometrical intersection of a vectorization of the raster and a geometry." msgstr "" #. Tag: para -#: reference_raster.xml:6460 +#: reference_raster.xml:6463 #, no-c-format msgid "The first three variants, returning a setof geomval, works in vector space. The raster is first vectorized (using ST_DumpAsPolygon) into a set of geomval rows and those rows are then intersected with the geometry using the ST_Intersection(geometry, geometry) PostGIS function. Geometries intersecting only with a nodata value area of a raster returns an empty geometry. They are normally excluded from the results by the proper usage of ST_Intersect in the WHERE clause." msgstr "" #. Tag: para -#: reference_raster.xml:6464 +#: reference_raster.xml:6467 #, no-c-format msgid "You can access the geometry and the value parts of the resulting set of geomval by surrounding them with parenthesis and adding '.geom' or '.val' at the end of the expression. e.g. (ST_Intersection(rast, geom)).geom" msgstr "" #. Tag: para -#: reference_raster.xml:6468 +#: reference_raster.xml:6471 #, no-c-format msgid "The other variants, returning a raster, works in raster space. They are using the two rasters version of ST_MapAlgebraExpr to perform the intersection." msgstr "" #. Tag: para -#: reference_raster.xml:6472 +#: reference_raster.xml:6475 #, no-c-format msgid "The extent of the resulting raster corresponds to the geometrical intersection of the two raster extents. The resulting raster includes 'BAND1', 'BAND2' or 'BOTH' bands, following what is passed as the returnband parameter. Nodata value areas present in any band results in nodata value areas in every bands of the result. In other words, any pixel intersecting with a nodata value pixel becomes a nodata value pixel in the result." msgstr "" #. Tag: para -#: reference_raster.xml:6476 +#: reference_raster.xml:6479 #, no-c-format msgid "Rasters resulting from ST_Intersection must have a nodata value assigned for areas not intersecting. You can define or replace the nodata value for any resulting band by providing a nodataval[] array of one or two nodata values depending if you request 'BAND1', 'BAND2' or 'BOTH' bands. The first value in the array replace the nodata value in the first band and the second value replace the nodata value in the second band. If one input band do not have a nodata value defined and none are provided as an array, one is chosen using the ST_MinPossibleValue function. All variant accepting an array of nodata value can also accept a single value which will be assigned to each requested band." msgstr "" #. Tag: para -#: reference_raster.xml:6480 +#: reference_raster.xml:6483 #, no-c-format msgid "In all variants, if no band number is specified band 1 is assumed." msgstr "" #. Tag: para -#: reference_raster.xml:6485 +#: reference_raster.xml:6488 #, no-c-format msgid "To get more control on the resulting extent or on what to return when encountering a nodata value, use the two rasters version of ." msgstr "" #. Tag: para -#: reference_raster.xml:6491 +#: reference_raster.xml:6494 #, no-c-format msgid "To compute the intersection of a raster band with a geometry in raster space, use . ST_Clip works on multiple bands rasters and does not return a band corresponding to the rasterized geometry." msgstr "" #. Tag: para -#: reference_raster.xml:6497 +#: reference_raster.xml:6500 #, no-c-format msgid "ST_Intersection should be used in conjunction with ST_Intersects and an index on the raster column and/or the geometry column." msgstr "" #. Tag: para -#: reference_raster.xml:6502 +#: reference_raster.xml:6505 #, no-c-format msgid "Enhanced: 2.0.0 - Intersection in the raster space was introduced. In earlier pre-2.0.0 versions, only intersection performed in vector space were supported." msgstr "" #. Tag: title -#: reference_raster.xml:6508 +#: reference_raster.xml:6511 #, no-c-format msgid "Examples: Geometry, Raster -- resulting in geometry vals" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6510 +#: reference_raster.xml:6513 #, no-c-format msgid "" "SELECT\n" @@ -7848,85 +7896,85 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:6514 +#: reference_raster.xml:6517 #, no-c-format msgid "Example: Raster, Geometry -- resulting is a raster" msgstr "" #. Tag: para -#: reference_raster.xml:6515 +#: reference_raster.xml:6518 #, no-c-format msgid "Examples coming soon" msgstr "" #. Tag: para -#: reference_raster.xml:6521 +#: reference_raster.xml:6524 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:6533 reference_raster.xml:6780 +#: reference_raster.xml:6536 reference_raster.xml:6783 #, no-c-format msgid "ST_MapAlgebra" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:6534 +#: reference_raster.xml:6537 #, no-c-format msgid "Callback function version - Returns a one-band raster given one or more input rasters, band indexes and one user-specified callback function." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:6540 +#: reference_raster.xml:6543 #, no-c-format msgid " raster ST_MapAlgebra rastbandarg[] rastbandargset regprocedure callbackfunc text pixeltype=NULL text extenttype=INTERSECTION raster customextent=NULL integer distancex=0 integer distancey=0 text[] VARIADIC userargs=NULL raster ST_MapAlgebra raster rast integer[] nband regprocedure callbackfunc text pixeltype=NULL text extenttype=FIRST raster customextent=NULL integer distancex=0 integer distancey=0 text[] VARIADIC userargs=NULL raster ST_MapAlgebra raster rast integer nband regprocedure callbackfunc text pixeltype=NULL text extenttype=FIRST raster customextent=NULL integer distancex=0 integer distancey=0 text[] VARIADIC userargs=NULL raster ST_MapAlgebra raster rast1 integer nband1 raster rast2 integer nband2 regprocedure callbackfunc text pixeltype=NULL text extenttype=INTERSECTION raster customextent=NULL integer distancex=0 integer distancey=0 text[] VARIADIC userargs=NULL " msgstr "" #. Tag: para -#: reference_raster.xml:6601 +#: reference_raster.xml:6604 #, no-c-format msgid "Returns a one-band raster given one or more input rasters, band indexes and one user-specified callback function." msgstr "" #. Tag: term -#: reference_raster.xml:6607 +#: reference_raster.xml:6610 #, no-c-format msgid "rast,rast1,rast2, rastbandargset" msgstr "" #. Tag: para -#: reference_raster.xml:6609 +#: reference_raster.xml:6612 #, no-c-format msgid "Rasters on which the map algebra process is evaluated." msgstr "" #. Tag: para -#: reference_raster.xml:6610 +#: reference_raster.xml:6613 #, no-c-format msgid "rastbandargset allows the use of a map algebra operation on many rasters and/or many bands. See example Variant 1." msgstr "" #. Tag: term -#: reference_raster.xml:6615 +#: reference_raster.xml:6618 #, no-c-format msgid "nband, nband1, nband2" msgstr "" #. Tag: para -#: reference_raster.xml:6617 +#: reference_raster.xml:6620 #, no-c-format msgid "Band numbers of the raster to be evaluated. nband can be an integer or integer[] denoting the bands. nband1 is band on rast1 and nband2 is band on rast2 for hte 2 raster/2band case." msgstr "" #. Tag: term -#: reference_raster.xml:6623 +#: reference_raster.xml:6626 #, no-c-format msgid "callbackfunc" msgstr "" #. Tag: para -#: reference_raster.xml:6625 +#: reference_raster.xml:6628 #, no-c-format msgid "" "The callbackfunc parameter must be the name and signature of an SQL or PL/pgSQL function, cast to a regprocedure. An example PL/pgSQL function example is: \n" @@ -7941,7 +7989,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6632 +#: reference_raster.xml:6635 #, no-c-format msgid "" "Passing a regprocedure argument to a SQL function requires the full function signature to be passed, then cast to a regprocedure type. To pass the above example PL/pgSQL function as an argument, the SQL for the argument is: \n" @@ -7950,121 +7998,121 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:6644 reference_raster.xml:6894 reference_raster.xml:7189 reference_raster.xml:7743 +#: reference_raster.xml:6647 reference_raster.xml:6897 reference_raster.xml:7192 reference_raster.xml:7746 #, no-c-format msgid "pixeltype" msgstr "" #. Tag: para -#: reference_raster.xml:6646 +#: reference_raster.xml:6649 #, no-c-format msgid "If pixeltype is passed in, the one band of the new raster will be of that pixeltype. If pixeltype is passed NULL or left out, the new raster band will have the same pixeltype as the specified band of the first raster (for extent types: INTERSECTION, UNION, FIRST, CUSTOM) or the specified band of the appropriate raster (for extent types: SECOND, LAST). If in doubt, always specify pixeltype." msgstr "" #. Tag: para -#: reference_raster.xml:6649 +#: reference_raster.xml:6652 #, no-c-format msgid "The resulting pixel type of the output raster must be one listed in or left out or set to NULL." msgstr "" #. Tag: term -#: reference_raster.xml:6656 reference_raster.xml:6902 reference_raster.xml:7198 +#: reference_raster.xml:6659 reference_raster.xml:6905 reference_raster.xml:7201 #, no-c-format msgid "extenttype" msgstr "" #. Tag: para -#: reference_raster.xml:6658 +#: reference_raster.xml:6661 #, no-c-format msgid "Possible values are INTERSECTION (default), UNION, FIRST (default for one raster variants), SECOND, LAST, CUSTOM." msgstr "" #. Tag: term -#: reference_raster.xml:6665 +#: reference_raster.xml:6668 #, no-c-format msgid "customextent" msgstr "" #. Tag: para -#: reference_raster.xml:6667 +#: reference_raster.xml:6670 #, no-c-format msgid "If extentype is CUSTOM, a raster must be provided for customextent. See example 4 of Variant 1." msgstr "" #. Tag: term -#: reference_raster.xml:6674 +#: reference_raster.xml:6677 #, no-c-format msgid "distancex" msgstr "" #. Tag: para -#: reference_raster.xml:6676 +#: reference_raster.xml:6679 #, no-c-format msgid "The distance in pixels from the reference cell. So width of resulting matrix would be 2*distancex + 1.If not specified only the reference cell is considered (neighborhood of 0)." msgstr "" #. Tag: term -#: reference_raster.xml:6683 +#: reference_raster.xml:6686 #, no-c-format msgid "distancey" msgstr "" #. Tag: para -#: reference_raster.xml:6685 +#: reference_raster.xml:6688 #, no-c-format msgid "The distance in pixels from reference cell in y direction. Height of resulting matrix would be 2*distancey + 1 .If not specified only the reference cell is considered (neighborhood of 0)." msgstr "" #. Tag: term -#: reference_raster.xml:6692 +#: reference_raster.xml:6695 #, no-c-format msgid "userargs" msgstr "" #. Tag: para -#: reference_raster.xml:6694 +#: reference_raster.xml:6697 #, no-c-format msgid "The third argument to the callbackfunc is a variadic text array. All trailing text arguments are passed through to the specified callbackfunc, and are contained in the userargs argument." msgstr "" #. Tag: para -#: reference_raster.xml:6702 reference_raster.xml:7518 reference_raster.xml:7637 +#: reference_raster.xml:6705 reference_raster.xml:7521 reference_raster.xml:7640 #, no-c-format msgid "For more information about the VARIADIC keyword, please refer to the PostgreSQL documentation and the \"SQL Functions with Variable Numbers of Arguments\" section of Query Language (SQL) Functions." msgstr "" #. Tag: para -#: reference_raster.xml:6708 +#: reference_raster.xml:6711 #, no-c-format msgid "The text[] argument to the callbackfunc is required, regardless of whether you choose to pass any arguments to the callback function for processing or not." msgstr "" #. Tag: para -#: reference_raster.xml:6713 +#: reference_raster.xml:6716 #, no-c-format msgid "Variant 1 accepts an array of rastbandarg allowing the use of a map algebra operation on many rasters and/or many bands. See example Variant 1." msgstr "" #. Tag: para -#: reference_raster.xml:6717 +#: reference_raster.xml:6720 #, no-c-format msgid "Variants 2 and 3 operate upon one or more bands of one raster. See example Variant 2 and 3." msgstr "" #. Tag: para -#: reference_raster.xml:6721 +#: reference_raster.xml:6724 #, no-c-format msgid "Variant 4 operate upon two rasters with one band per raster. See example Variant 4." msgstr "" #. Tag: para -#: reference_raster.xml:6732 reference_raster.xml:6754 +#: reference_raster.xml:6735 reference_raster.xml:6757 #, no-c-format msgid "One raster, one band" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6733 +#: reference_raster.xml:6736 #, no-c-format msgid "" "WITH foo AS (\n" @@ -8079,13 +8127,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6735 reference_raster.xml:6751 +#: reference_raster.xml:6738 reference_raster.xml:6754 #, no-c-format msgid "One raster, several bands" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6736 +#: reference_raster.xml:6739 #, no-c-format msgid "" "WITH foo AS (\n" @@ -8100,13 +8148,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6738 +#: reference_raster.xml:6741 #, no-c-format msgid "Several rasters, several bands" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6739 +#: reference_raster.xml:6742 #, no-c-format msgid "" "WITH foo AS (\n" @@ -8125,13 +8173,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6741 +#: reference_raster.xml:6744 #, no-c-format msgid "Complete example of tiles of a coverage with neighborhood. This query only works with PostgreSQL 9.1 or higher." msgstr "" #. Tag: programlisting -#: reference_raster.xml:6742 +#: reference_raster.xml:6745 #, no-c-format msgid "" "WITH foo AS (\n" @@ -8165,13 +8213,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6744 +#: reference_raster.xml:6747 #, no-c-format msgid "Example like the prior one for tiles of a coverage with neighborhood but works with PostgreSQL 9.0." msgstr "" #. Tag: programlisting -#: reference_raster.xml:6745 +#: reference_raster.xml:6748 #, no-c-format msgid "" "WITH src AS (\n" @@ -8220,13 +8268,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:6749 +#: reference_raster.xml:6752 #, no-c-format msgid "Examples: Variants 2 and 3" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6752 +#: reference_raster.xml:6755 #, no-c-format msgid "" "WITH foo AS (\n" @@ -8241,7 +8289,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6755 +#: reference_raster.xml:6758 #, no-c-format msgid "" "WITH foo AS (\n" @@ -8256,19 +8304,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:6759 +#: reference_raster.xml:6762 #, no-c-format msgid "Examples: Variant 4" msgstr "" #. Tag: para -#: reference_raster.xml:6761 +#: reference_raster.xml:6764 #, no-c-format msgid "Two rasters, two bands" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6762 +#: reference_raster.xml:6765 #, no-c-format msgid "" "WITH foo AS (\n" @@ -8288,235 +8336,235 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6769 +#: reference_raster.xml:6772 #, no-c-format msgid ", , " msgstr "" #. Tag: refpurpose -#: reference_raster.xml:6781 +#: reference_raster.xml:6784 #, no-c-format msgid "Expression version - Returns a one-band raster given one or two input rasters, band indexes and one or more user-specified SQL expressions." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:6787 +#: reference_raster.xml:6790 #, no-c-format msgid " raster ST_MapAlgebra raster rast integer nband text pixeltype text expression double precision nodataval=NULL raster ST_MapAlgebra raster rast text pixeltype text expression double precision nodataval=NULL raster ST_MapAlgebra raster rast1 integer nband1 raster rast2 integer nband2 text expression text pixeltype=NULL text extenttype=INTERSECTION text nodata1expr=NULL text nodata2expr=NULL double precision nodatanodataval=NULL raster ST_MapAlgebra raster rast1 raster rast2 text expression text pixeltype=NULL text extenttype=INTERSECTION text nodata1expr=NULL text nodata2expr=NULL double precision nodatanodataval=NULL " msgstr "" #. Tag: para -#: reference_raster.xml:6838 +#: reference_raster.xml:6841 #, no-c-format msgid "Expression version - Returns a one-band raster given one or two input rasters, band indexes and one or more user-specified SQL expressions." msgstr "" #. Tag: title -#: reference_raster.xml:6846 +#: reference_raster.xml:6849 #, no-c-format msgid "Description: Variants 1 and 2 (one raster)" msgstr "" #. Tag: para -#: reference_raster.xml:6848 +#: reference_raster.xml:6851 #, no-c-format msgid "Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation defined by the expression on the input raster (rast). If nband is not provided, band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster but will only have one band." msgstr "" #. Tag: para -#: reference_raster.xml:6852 reference_raster.xml:7054 reference_raster.xml:7502 +#: reference_raster.xml:6855 reference_raster.xml:7057 reference_raster.xml:7505 #, no-c-format msgid "If pixeltype is passed in, then the new raster will have a band of that pixeltype. If pixeltype is passed NULL, then the new raster band will have the same pixeltype as the input rast band." msgstr "" #. Tag: para -#: reference_raster.xml:6857 +#: reference_raster.xml:6860 #, no-c-format msgid "Keywords permitted for expression" msgstr "" #. Tag: para -#: reference_raster.xml:6860 +#: reference_raster.xml:6863 #, no-c-format msgid "[rast] - Pixel value of the pixel of interest" msgstr "" #. Tag: para -#: reference_raster.xml:6863 +#: reference_raster.xml:6866 #, no-c-format msgid "[rast.val] - Pixel value of the pixel of interest" msgstr "" #. Tag: para -#: reference_raster.xml:6866 +#: reference_raster.xml:6869 #, no-c-format msgid "[rast.x] - 1-based pixel column of the pixel of interest" msgstr "" #. Tag: para -#: reference_raster.xml:6869 +#: reference_raster.xml:6872 #, no-c-format msgid "[rast.y] - 1-based pixel row of the pixel of interest" msgstr "" #. Tag: title -#: reference_raster.xml:6878 +#: reference_raster.xml:6881 #, no-c-format msgid "Description: Variants 3 and 4 (two raster)" msgstr "" #. Tag: para -#: reference_raster.xml:6880 reference_raster.xml:7174 +#: reference_raster.xml:6883 reference_raster.xml:7177 #, no-c-format msgid "Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation to the two bands defined by the expression on the two input raster bands rast1, (rast2). If no band1, band2 is specified band 1 is assumed. The resulting raster will be aligned (scale, skew and pixel corners) on the grid defined by the first raster. The resulting raster will have the extent defined by the extenttype parameter." msgstr "" #. Tag: term -#: reference_raster.xml:6886 reference_raster.xml:7180 +#: reference_raster.xml:6889 reference_raster.xml:7183 #, no-c-format msgid "expression" msgstr "" #. Tag: para -#: reference_raster.xml:6888 reference_raster.xml:7182 +#: reference_raster.xml:6891 reference_raster.xml:7185 #, no-c-format msgid "A PostgreSQL algebraic expression involving the two rasters and PostgreSQL defined functions/operators that will define the pixel value when pixels intersect. e.g. (([rast1] + [rast2])/2.0)::integer" msgstr "" #. Tag: para -#: reference_raster.xml:6896 reference_raster.xml:7191 +#: reference_raster.xml:6899 reference_raster.xml:7194 #, no-c-format msgid "The resulting pixel type of the output raster. Must be one listed in , left out or set to NULL. If not passed in or set to NULL, will default to the pixeltype of the first raster." msgstr "" #. Tag: para -#: reference_raster.xml:6904 reference_raster.xml:7200 +#: reference_raster.xml:6907 reference_raster.xml:7203 #, no-c-format msgid "Controls the extent of resulting raster" msgstr "" #. Tag: para -#: reference_raster.xml:6910 reference_raster.xml:7203 +#: reference_raster.xml:6913 reference_raster.xml:7206 #, no-c-format msgid "INTERSECTION - The extent of the new raster is the intersection of the two rasters. This is the default." msgstr "" #. Tag: para -#: reference_raster.xml:6915 reference_raster.xml:7208 +#: reference_raster.xml:6918 reference_raster.xml:7211 #, no-c-format msgid "UNION - The extent of the new raster is the union of the two rasters." msgstr "" #. Tag: para -#: reference_raster.xml:6920 reference_raster.xml:7213 +#: reference_raster.xml:6923 reference_raster.xml:7216 #, no-c-format msgid "FIRST - The extent of the new raster is the same as the one of the first raster." msgstr "" #. Tag: para -#: reference_raster.xml:6925 reference_raster.xml:7218 +#: reference_raster.xml:6928 reference_raster.xml:7221 #, no-c-format msgid "SECOND - The extent of the new raster is the same as the one of the second raster." msgstr "" #. Tag: term -#: reference_raster.xml:6933 reference_raster.xml:7227 +#: reference_raster.xml:6936 reference_raster.xml:7230 #, no-c-format msgid "nodata1expr" msgstr "" #. Tag: para -#: reference_raster.xml:6935 reference_raster.xml:7229 +#: reference_raster.xml:6938 reference_raster.xml:7232 #, no-c-format msgid "An algebraic expression involving only rast2 or a constant that defines what to return when pixels of rast1 are nodata values and spatially corresponding rast2 pixels have values." msgstr "" #. Tag: term -#: reference_raster.xml:6941 reference_raster.xml:7236 +#: reference_raster.xml:6944 reference_raster.xml:7239 #, no-c-format msgid "nodata2expr" msgstr "" #. Tag: para -#: reference_raster.xml:6943 reference_raster.xml:7238 +#: reference_raster.xml:6946 reference_raster.xml:7241 #, no-c-format msgid "An algebraic expression involving only rast1 or a constant that defines what to return when pixels of rast2 are nodata values and spatially corresponding rast1 pixels have values." msgstr "" #. Tag: term -#: reference_raster.xml:6949 reference_raster.xml:7245 +#: reference_raster.xml:6952 reference_raster.xml:7248 #, no-c-format msgid "nodatanodataval" msgstr "" #. Tag: para -#: reference_raster.xml:6951 reference_raster.xml:7247 +#: reference_raster.xml:6954 reference_raster.xml:7250 #, no-c-format msgid "A numeric constant to return when spatially corresponding rast1 and rast2 pixels are both nodata values." msgstr "" #. Tag: para -#: reference_raster.xml:6959 +#: reference_raster.xml:6962 #, no-c-format msgid "Keywords permitted in expression, nodata1expr and nodata2expr" msgstr "" #. Tag: para -#: reference_raster.xml:6962 +#: reference_raster.xml:6965 #, no-c-format msgid "[rast1] - Pixel value of the pixel of interest from rast1" msgstr "" #. Tag: para -#: reference_raster.xml:6965 +#: reference_raster.xml:6968 #, no-c-format msgid "[rast1.val] - Pixel value of the pixel of interest from rast1" msgstr "" #. Tag: para -#: reference_raster.xml:6968 +#: reference_raster.xml:6971 #, no-c-format msgid "[rast1.x] - 1-based pixel column of the pixel of interest from rast1" msgstr "" #. Tag: para -#: reference_raster.xml:6971 +#: reference_raster.xml:6974 #, no-c-format msgid "[rast1.y] - 1-based pixel row of the pixel of interest from rast1" msgstr "" #. Tag: para -#: reference_raster.xml:6974 +#: reference_raster.xml:6977 #, no-c-format msgid "[rast2] - Pixel value of the pixel of interest from rast2" msgstr "" #. Tag: para -#: reference_raster.xml:6977 +#: reference_raster.xml:6980 #, no-c-format msgid "[rast2.val] - Pixel value of the pixel of interest from rast2" msgstr "" #. Tag: para -#: reference_raster.xml:6980 +#: reference_raster.xml:6983 #, no-c-format msgid "[rast2.x] - 1-based pixel column of the pixel of interest from rast2" msgstr "" #. Tag: para -#: reference_raster.xml:6983 +#: reference_raster.xml:6986 #, no-c-format msgid "[rast2.y] - 1-based pixel row of the pixel of interest from rast2" msgstr "" #. Tag: title -#: reference_raster.xml:6991 +#: reference_raster.xml:6994 #, no-c-format msgid "Examples: Variants 1 and 2" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6993 +#: reference_raster.xml:6996 #, no-c-format msgid "" "WITH foo AS (\n" @@ -8528,13 +8576,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:6997 +#: reference_raster.xml:7000 #, no-c-format msgid "Examples: Variant 3 and 4" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6999 +#: reference_raster.xml:7002 #, no-c-format msgid "" "WITH foo AS (\n" @@ -8554,55 +8602,55 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7005 +#: reference_raster.xml:7008 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:7015 reference_raster.xml:7129 +#: reference_raster.xml:7018 reference_raster.xml:7132 #, no-c-format msgid "ST_MapAlgebraExpr" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:7016 +#: reference_raster.xml:7019 #, no-c-format msgid "1 raster band version: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation on the input raster band and of pixeltype provided. Band 1 is assumed if no band is specified." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:7020 +#: reference_raster.xml:7023 #, no-c-format msgid " raster ST_MapAlgebraExpr raster rast integer band text pixeltype text expression double precision nodataval=NULL raster ST_MapAlgebraExpr raster rast text pixeltype text expression double precision nodataval=NULL " msgstr "" #. Tag: para -#: reference_raster.xml:7045 reference_raster.xml:7169 +#: reference_raster.xml:7048 reference_raster.xml:7172 #, no-c-format msgid "is deprecated as of 2.1.0. Use instead." msgstr "" #. Tag: para -#: reference_raster.xml:7050 +#: reference_raster.xml:7053 #, no-c-format msgid "Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation defined by the expression on the input raster (rast). If no band is specified band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster but will only have one band." msgstr "" #. Tag: para -#: reference_raster.xml:7058 +#: reference_raster.xml:7061 #, no-c-format msgid "In the expression you can use the term [rast] to refer to the pixel value of the original band, [rast.x] to refer to the 1-based pixel column index, [rast.y] to refer to the 1-based pixel row index." msgstr "" #. Tag: para -#: reference_raster.xml:7068 reference_raster.xml:7267 reference_raster.xml:7531 +#: reference_raster.xml:7071 reference_raster.xml:7270 reference_raster.xml:7534 #, no-c-format msgid "Create a new 1 band raster from our original that is a function of modulo 2 of the original raster band." msgstr "" #. Tag: programlisting -#: reference_raster.xml:7069 +#: reference_raster.xml:7072 #, no-c-format msgid "" "ALTER TABLE dummy_rast ADD COLUMN map_rast raster;\n" @@ -8630,13 +8678,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7071 +#: reference_raster.xml:7074 #, no-c-format msgid "Create a new 1 band raster of pixel-type 2BUI from our original that is reclassified and set the nodata value to be 0." msgstr "" #. Tag: programlisting -#: reference_raster.xml:7072 +#: reference_raster.xml:7075 #, no-c-format msgid "" "ALTER TABLE dummy_rast ADD COLUMN map_rast2 raster;\n" @@ -8672,25 +8720,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7086 reference_raster.xml:7546 +#: reference_raster.xml:7089 reference_raster.xml:7549 #, no-c-format msgid "original (column rast-view)" msgstr "" #. Tag: para -#: reference_raster.xml:7100 reference_raster.xml:7554 +#: reference_raster.xml:7103 reference_raster.xml:7557 #, no-c-format msgid "rast_view_ma" msgstr "" #. Tag: para -#: reference_raster.xml:7111 reference_raster.xml:7562 +#: reference_raster.xml:7114 reference_raster.xml:7565 #, no-c-format msgid "Create a new 3 band raster same pixel type from our original 3 band raster with first band altered by map algebra and remaining 2 bands unaltered." msgstr "" #. Tag: programlisting -#: reference_raster.xml:7112 +#: reference_raster.xml:7115 #, no-c-format msgid "" "SELECT\n" @@ -8709,43 +8757,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7117 +#: reference_raster.xml:7120 #, no-c-format msgid ", , , , " msgstr "" #. Tag: refpurpose -#: reference_raster.xml:7130 +#: reference_raster.xml:7133 #, no-c-format msgid "2 raster band version: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation on the two input raster bands and of pixeltype provided. band 1 of each raster is assumed if no band numbers are specified. The resulting raster will be aligned (scale, skew and pixel corners) on the grid defined by the first raster and have its extent defined by the \"extenttype\" parameter. Values for \"extenttype\" can be: INTERSECTION, UNION, FIRST, SECOND." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:7136 +#: reference_raster.xml:7139 #, no-c-format msgid " raster ST_MapAlgebraExpr raster rast1 raster rast2 text expression text pixeltype=same_as_rast1_band text extenttype=INTERSECTION text nodata1expr=NULL text nodata2expr=NULL double precision nodatanodataval=NULL raster ST_MapAlgebraExpr raster rast1 integer band1 raster rast2 integer band2 text expression text pixeltype=same_as_rast1_band text extenttype=INTERSECTION text nodata1expr=NULL text nodata2expr=NULL double precision nodatanodataval=NULL " msgstr "" #. Tag: para -#: reference_raster.xml:7254 +#: reference_raster.xml:7257 #, no-c-format msgid "If pixeltype is passed in, then the new raster will have a band of that pixeltype. If pixeltype is passed NULL or no pixel type specified, then the new raster band will have the same pixeltype as the input rast1 band." msgstr "" #. Tag: para -#: reference_raster.xml:7257 +#: reference_raster.xml:7260 #, no-c-format msgid "Use the term [rast1.val] [rast2.val] to refer to the pixel value of the original raster bands and [rast1.x], [rast1.y] etc. to refer to the column / row positions of the pixels." msgstr "" #. Tag: title -#: reference_raster.xml:7265 +#: reference_raster.xml:7268 #, no-c-format msgid "Example: 2 Band Intersection and Union" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7268 +#: reference_raster.xml:7271 #, no-c-format msgid "" "--Create a cool set of rasters --\n" @@ -8784,25 +8832,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7282 +#: reference_raster.xml:7285 #, no-c-format msgid "mapalgebra intersection" msgstr "" #. Tag: para -#: reference_raster.xml:7296 +#: reference_raster.xml:7299 #, no-c-format msgid "map algebra union" msgstr "" #. Tag: title -#: reference_raster.xml:7309 reference_raster.xml:7648 +#: reference_raster.xml:7312 reference_raster.xml:7651 #, no-c-format msgid "Example: Overlaying rasters on a canvas as separate bands" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7310 +#: reference_raster.xml:7313 #, no-c-format msgid "" "-- we use ST_AsPNG to render the image so all single band ones look grey --\n" @@ -8836,37 +8884,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7323 +#: reference_raster.xml:7326 #, no-c-format msgid "rast1" msgstr "" #. Tag: para -#: reference_raster.xml:7336 +#: reference_raster.xml:7339 #, no-c-format msgid "rast2" msgstr "" #. Tag: para -#: reference_raster.xml:7352 +#: reference_raster.xml:7355 #, no-c-format msgid "rast3" msgstr "" #. Tag: para -#: reference_raster.xml:7366 +#: reference_raster.xml:7369 #, no-c-format msgid "final_rast" msgstr "" #. Tag: title -#: reference_raster.xml:7379 +#: reference_raster.xml:7382 #, no-c-format msgid "Example: Overlay 2 meter boundary of select parcels over an aerial imagery" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7381 +#: reference_raster.xml:7384 #, no-c-format msgid "" "-- Create new 3 band raster composed of first 2 clipped bands, and overlay of 3rd band with our geometry\n" @@ -8897,49 +8945,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7395 +#: reference_raster.xml:7398 #, no-c-format msgid "The blue lines are the boundaries of select parcels" msgstr "" #. Tag: para -#: reference_raster.xml:7409 +#: reference_raster.xml:7412 #, no-c-format msgid ", , , , , , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:7426 reference_raster.xml:7579 +#: reference_raster.xml:7429 reference_raster.xml:7582 #, no-c-format msgid "ST_MapAlgebraFct" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:7427 +#: reference_raster.xml:7430 #, no-c-format msgid "1 band version - Creates a new one band raster formed by applying a valid PostgreSQL function on the input raster band and of pixeltype prodived. Band 1 is assumed if no band is specified." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:7431 +#: reference_raster.xml:7434 #, no-c-format msgid " raster ST_MapAlgebraFct raster rast regprocedure onerasteruserfunc raster ST_MapAlgebraFct raster rast regprocedure onerasteruserfunc text[] VARIADIC args raster ST_MapAlgebraFct raster rast text pixeltype regprocedure onerasteruserfunc raster ST_MapAlgebraFct raster rast text pixeltype regprocedure onerasteruserfunc text[] VARIADIC args raster ST_MapAlgebraFct raster rast integer band regprocedure onerasteruserfunc raster ST_MapAlgebraFct raster rast integer band regprocedure onerasteruserfunc text[] VARIADIC args raster ST_MapAlgebraFct raster rast integer band text pixeltype regprocedure onerasteruserfunc raster ST_MapAlgebraFct raster rast integer band text pixeltype regprocedure onerasteruserfunc text[] VARIADIC args " msgstr "" #. Tag: para -#: reference_raster.xml:7495 reference_raster.xml:7613 reference_raster.xml:7726 +#: reference_raster.xml:7498 reference_raster.xml:7616 reference_raster.xml:7729 #, no-c-format msgid "is deprecated as of 2.1.0. Use instead." msgstr "" #. Tag: para -#: reference_raster.xml:7500 +#: reference_raster.xml:7503 #, no-c-format msgid "Creates a new one band raster formed by applying a valid PostgreSQL function specified by the onerasteruserfunc on the input raster (rast). If no band is specified, band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster but will only have one band." msgstr "" #. Tag: para -#: reference_raster.xml:7504 +#: reference_raster.xml:7507 #, no-c-format msgid "" "The onerasteruserfunc parameter must be the name and signature of a SQL or PL/pgSQL function, cast to a regprocedure. A very simple and quite useless PL/pgSQL function example is: CREATE OR REPLACE FUNCTION simple_function(pixel FLOAT, pos INTEGER[], VARIADIC args TEXT[])\n" @@ -8951,25 +8999,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7509 +#: reference_raster.xml:7512 #, no-c-format msgid "Passing a regprodedure argument to a SQL function requires the full function signature to be passed, then cast to a regprocedure type. To pass the above example PL/pgSQL function as an argument, the SQL for the argument is:'simple_function(float,integer[],text[])'::regprocedureNote that the argument contains the name of the function, the types of the function arguments, quotes around the name and argument types, and a cast to a regprocedure." msgstr "" #. Tag: para -#: reference_raster.xml:7513 +#: reference_raster.xml:7516 #, no-c-format msgid "The third argument to the userfunction is a variadic text array. All trailing text arguments to any call are passed through to the specified userfunction, and are contained in the args argument." msgstr "" #. Tag: para -#: reference_raster.xml:7522 +#: reference_raster.xml:7525 #, no-c-format msgid "The text[] argument to the userfunction is required, regardless of whether you choose to pass any arguments to your user function for processing or not." msgstr "" #. Tag: programlisting -#: reference_raster.xml:7532 +#: reference_raster.xml:7535 #, no-c-format msgid "" "ALTER TABLE dummy_rast ADD COLUMN map_rast raster;\n" @@ -9002,13 +9050,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7534 +#: reference_raster.xml:7537 #, no-c-format msgid "Create a new 1 band raster of pixel-type 2BUI from our original that is reclassified and set the nodata value to a passed parameter to the user function (0)." msgstr "" #. Tag: programlisting -#: reference_raster.xml:7535 +#: reference_raster.xml:7538 #, no-c-format msgid "" "ALTER TABLE dummy_rast ADD COLUMN map_rast2 raster;\n" @@ -9058,7 +9106,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7563 +#: reference_raster.xml:7566 #, no-c-format msgid "" "CREATE FUNCTION rast_plus_tan(pixel float, pos integer[], variadic args text[])\n" @@ -9086,37 +9134,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7568 reference_raster.xml:7691 +#: reference_raster.xml:7571 reference_raster.xml:7694 #, no-c-format msgid ", , , " msgstr "" #. Tag: refpurpose -#: reference_raster.xml:7580 +#: reference_raster.xml:7583 #, no-c-format msgid "2 band version - Creates a new one band raster formed by applying a valid PostgreSQL function on the 2 input raster bands and of pixeltype prodived. Band 1 is assumed if no band is specified. Extent type defaults to INTERSECTION if not specified." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:7584 +#: reference_raster.xml:7587 #, no-c-format msgid " raster ST_MapAlgebraFct raster rast1 raster rast2 regprocedure tworastuserfunc text pixeltype=same_as_rast1 text extenttype=INTERSECTION text[] VARIADIC userargs raster ST_MapAlgebraFct raster rast1 integer band1 raster rast2 integer band2 regprocedure tworastuserfunc text pixeltype=same_as_rast1 text extenttype=INTERSECTION text[] VARIADIC userargs " msgstr "" #. Tag: para -#: reference_raster.xml:7618 +#: reference_raster.xml:7621 #, no-c-format msgid "Creates a new one band raster formed by applying a valid PostgreSQL function specified by the tworastuserfunc on the input raster rast1, rast2. If no band1 or band2 is specified, band 1 is assumed. The new raster will have the same georeference, width, and height as the original rasters but will only have one band." msgstr "" #. Tag: para -#: reference_raster.xml:7621 +#: reference_raster.xml:7624 #, no-c-format msgid "If pixeltype is passed in, then the new raster will have a band of that pixeltype. If pixeltype is passed NULL or left out, then the new raster band will have the same pixeltype as the input rast1 band." msgstr "" #. Tag: para -#: reference_raster.xml:7624 +#: reference_raster.xml:7627 #, no-c-format msgid "" "The tworastuserfunc parameter must be the name and signature of an SQL or PL/pgSQL function, cast to a regprocedure. An example PL/pgSQL function example is: CREATE OR REPLACE FUNCTION simple_function_for_two_rasters(pixel1 FLOAT, pixel2 FLOAT, pos INTEGER[], VARIADIC args TEXT[])\n" @@ -9128,25 +9176,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7630 +#: reference_raster.xml:7633 #, no-c-format msgid "Passing a regprodedure argument to a SQL function requires the full function signature to be passed, then cast to a regprocedure type. To pass the above example PL/pgSQL function as an argument, the SQL for the argument is:'simple_function(double precision, double precision, integer[], text[])'::regprocedureNote that the argument contains the name of the function, the types of the function arguments, quotes around the name and argument types, and a cast to a regprocedure." msgstr "" #. Tag: para -#: reference_raster.xml:7633 +#: reference_raster.xml:7636 #, no-c-format msgid "The third argument to the tworastuserfunc is a variadic text array. All trailing text arguments to any call are passed through to the specified tworastuserfunc, and are contained in the userargs argument." msgstr "" #. Tag: para -#: reference_raster.xml:7641 +#: reference_raster.xml:7644 #, no-c-format msgid "The text[] argument to the tworastuserfunc is required, regardless of whether you choose to pass any arguments to your user function for processing or not." msgstr "" #. Tag: programlisting -#: reference_raster.xml:7649 +#: reference_raster.xml:7652 #, no-c-format msgid "" "-- define our user defined function --\n" @@ -9215,19 +9263,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7662 +#: reference_raster.xml:7665 #, no-c-format msgid "map bands overlay (canvas) (R: small road, G: circle, B: big road)" msgstr "" #. Tag: title -#: reference_raster.xml:7674 +#: reference_raster.xml:7677 #, no-c-format msgid "User Defined function that takes extra args" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7675 +#: reference_raster.xml:7678 #, no-c-format msgid "" "CREATE OR REPLACE FUNCTION raster_mapalgebra_userargs(\n" @@ -9263,151 +9311,151 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7683 +#: reference_raster.xml:7686 #, no-c-format msgid "user defined with extra args and different bands from same raster" msgstr "" #. Tag: refname -#: reference_raster.xml:7702 +#: reference_raster.xml:7705 #, no-c-format msgid "ST_MapAlgebraFctNgb" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:7703 +#: reference_raster.xml:7706 #, no-c-format msgid "1-band version: Map Algebra Nearest Neighbor using user-defined PostgreSQL function. Return a raster which values are the result of a PLPGSQL user function involving a neighborhood of values from the input raster band." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:7708 +#: reference_raster.xml:7711 #, no-c-format msgid "raster ST_MapAlgebraFctNgb raster rast integer band text pixeltype integer ngbwidth integer ngbheight regprocedure onerastngbuserfunc text nodatamode text[] VARIADIC args" msgstr "" #. Tag: para -#: reference_raster.xml:7731 +#: reference_raster.xml:7734 #, no-c-format msgid "(one raster version) Return a raster which values are the result of a PLPGSQL user function involving a neighborhood of values from the input raster band. The user function takes the neighborhood of pixel values as an array of numbers, for each pixel, returns the result from the user function, replacing pixel value of currently inspected pixel with the function result." msgstr "" #. Tag: term -#: reference_raster.xml:7735 +#: reference_raster.xml:7738 #, no-c-format msgid "rast" msgstr "" #. Tag: para -#: reference_raster.xml:7736 +#: reference_raster.xml:7739 #, no-c-format msgid "Raster on which the user function is evaluated." msgstr "" #. Tag: term -#: reference_raster.xml:7739 +#: reference_raster.xml:7742 #, no-c-format msgid "band" msgstr "" #. Tag: para -#: reference_raster.xml:7740 +#: reference_raster.xml:7743 #, no-c-format msgid "Band number of the raster to be evaluated. Default to 1." msgstr "" #. Tag: para -#: reference_raster.xml:7744 +#: reference_raster.xml:7747 #, no-c-format msgid "The resulting pixel type of the output raster. Must be one listed in or left out or set to NULL. If not passed in or set to NULL, will default to the pixeltype of the rast. Results are truncated if they are larger than what is allowed for the pixeltype." msgstr "" #. Tag: term -#: reference_raster.xml:7747 +#: reference_raster.xml:7750 #, no-c-format msgid "ngbwidth" msgstr "" #. Tag: para -#: reference_raster.xml:7748 +#: reference_raster.xml:7751 #, no-c-format msgid "The width of the neighborhood, in cells." msgstr "" #. Tag: term -#: reference_raster.xml:7751 +#: reference_raster.xml:7754 #, no-c-format msgid "ngbheight" msgstr "" #. Tag: para -#: reference_raster.xml:7752 +#: reference_raster.xml:7755 #, no-c-format msgid "The height of the neighborhood, in cells." msgstr "" #. Tag: term -#: reference_raster.xml:7755 +#: reference_raster.xml:7758 #, no-c-format msgid "onerastngbuserfunc" msgstr "" #. Tag: para -#: reference_raster.xml:7756 +#: reference_raster.xml:7759 #, no-c-format msgid "PLPGSQL/psql user function to apply to neighborhood pixels of a single band of a raster. The first element is a 2-dimensional array of numbers representing the rectangular pixel neighborhood" msgstr "" #. Tag: term -#: reference_raster.xml:7759 +#: reference_raster.xml:7762 #, no-c-format msgid "nodatamode" msgstr "" #. Tag: para -#: reference_raster.xml:7761 +#: reference_raster.xml:7764 #, no-c-format msgid "Defines what value to pass to the function for a neighborhood pixel that is nodata or NULL" msgstr "" #. Tag: para -#: reference_raster.xml:7762 +#: reference_raster.xml:7765 #, no-c-format msgid "'ignore': any NODATA values encountered in the neighborhood are ignored by the computation -- this flag must be sent to the user callback function, and the user function decides how to ignore it." msgstr "" #. Tag: para -#: reference_raster.xml:7763 +#: reference_raster.xml:7766 #, no-c-format msgid "'NULL': any NODATA values encountered in the neighborhood will cause the resulting pixel to be NULL -- the user callback function is skipped in this case." msgstr "" #. Tag: para -#: reference_raster.xml:7764 +#: reference_raster.xml:7767 #, no-c-format msgid "'value': any NODATA values encountered in the neighborhood are replaced by the reference pixel (the one in the center of the neighborhood). Note that if this value is NODATA, the behavior is the same as 'NULL' (for the affected neighborhood)" msgstr "" #. Tag: term -#: reference_raster.xml:7768 +#: reference_raster.xml:7771 #, no-c-format msgid "args" msgstr "" #. Tag: para -#: reference_raster.xml:7769 +#: reference_raster.xml:7772 #, no-c-format msgid "Arguments to pass into the user function." msgstr "" #. Tag: para -#: reference_raster.xml:7779 +#: reference_raster.xml:7782 #, no-c-format msgid "Examples utilize the katrina raster loaded as a single tile described in http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html and then prepared in the examples" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7781 +#: reference_raster.xml:7784 #, no-c-format msgid "" "--\n" @@ -9444,67 +9492,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7795 +#: reference_raster.xml:7798 #, no-c-format msgid "First band of our raster" msgstr "" #. Tag: para -#: reference_raster.xml:7809 +#: reference_raster.xml:7812 #, no-c-format msgid "new raster after averaging pixels withing 4x4 pixels of each other" msgstr "" #. Tag: para -#: reference_raster.xml:7824 +#: reference_raster.xml:7827 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:7834 +#: reference_raster.xml:7837 #, no-c-format msgid "ST_Reclass" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:7835 +#: reference_raster.xml:7838 #, no-c-format msgid "Creates a new raster composed of band types reclassified from original. The nband is the band to be changed. If nband is not specified assumed to be 1. All other bands are returned unchanged. Use case: convert a 16BUI band to a 8BUI and so forth for simpler rendering as viewable formats." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:7839 +#: reference_raster.xml:7842 #, no-c-format msgid " raster ST_Reclass raster rast integer nband text reclassexpr text pixeltype double precision nodataval=NULL raster ST_Reclass raster rast reclassarg[] VARIADIC reclassargset raster ST_Reclass raster rast text reclassexpr text pixeltype " msgstr "" #. Tag: para -#: reference_raster.xml:7867 +#: reference_raster.xml:7870 #, no-c-format msgid "Creates a new raster formed by applying a valid PostgreSQL algebraic operation defined by the reclassexpr on the input raster (rast). If no band is specified band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster. Bands not designated will come back unchanged. Refer to for description of valid reclassification expressions." msgstr "" #. Tag: para -#: reference_raster.xml:7869 +#: reference_raster.xml:7872 #, no-c-format msgid "The bands of the new raster will have pixel type of pixeltype. If reclassargset is passed in then each reclassarg defines behavior of each band generated." msgstr "" #. Tag: title -#: reference_raster.xml:7875 +#: reference_raster.xml:7878 #, no-c-format msgid "Examples Basic" msgstr "" #. Tag: para -#: reference_raster.xml:7876 +#: reference_raster.xml:7879 #, no-c-format msgid "Create a new raster from the original where band 2 is converted from 8BUI to 4BUI and all values from 101-254 are set to nodata value." msgstr "" #. Tag: programlisting -#: reference_raster.xml:7877 +#: reference_raster.xml:7880 #, no-c-format msgid "" "ALTER TABLE dummy_rast ADD COLUMN reclass_rast raster;\n" @@ -9530,19 +9578,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:7881 +#: reference_raster.xml:7884 #, no-c-format msgid "Example: Advanced using multiple reclassargs" msgstr "" #. Tag: para -#: reference_raster.xml:7883 +#: reference_raster.xml:7886 #, no-c-format msgid "Create a new raster from the original where band 1,2,3 is converted to 1BB,4BUI, 4BUI respectively and reclassified. Note this uses the variadic reclassarg argument which can take as input an indefinite number of reclassargs (theoretically as many bands as you have)" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7884 +#: reference_raster.xml:7887 #, no-c-format msgid "" "UPDATE dummy_rast SET reclass_rast = \n" @@ -9572,19 +9620,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:7888 +#: reference_raster.xml:7891 #, no-c-format msgid "Example: Advanced Map a single band 32BF raster to multiple viewable bands" msgstr "" #. Tag: para -#: reference_raster.xml:7889 +#: reference_raster.xml:7892 #, no-c-format msgid "Create a new 3 band (8BUI,8BUI,8BUI viewable raster) from a raster that has only one 32bf band" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7890 +#: reference_raster.xml:7893 #, no-c-format msgid "" "ALTER TABLE wind ADD COLUMN rast_view raster;\n" @@ -9599,97 +9647,97 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7895 +#: reference_raster.xml:7898 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:7908 +#: reference_raster.xml:7911 #, no-c-format msgid "ST_Union" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:7909 +#: reference_raster.xml:7912 #, no-c-format msgid "Returns the union of a set of raster tiles into a single raster composed of 1 or more bands." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:7914 +#: reference_raster.xml:7917 #, no-c-format msgid "raster ST_Union setof raster rast" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:7920 +#: reference_raster.xml:7923 #, no-c-format msgid "raster ST_Union setof raster rast unionarg[] unionargset" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:7927 +#: reference_raster.xml:7930 #, no-c-format msgid "raster ST_Union setof raster rast integer nband" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:7934 +#: reference_raster.xml:7937 #, no-c-format msgid "raster ST_Union setof raster rast text uniontype" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:7941 +#: reference_raster.xml:7944 #, no-c-format msgid "raster ST_Union setof raster rast integer nband text uniontype" msgstr "" #. Tag: para -#: reference_raster.xml:7953 +#: reference_raster.xml:7956 #, no-c-format msgid "Returns the union of a set of raster tiles into a single raster composed of at least one band. The resulting raster's extent is the extent of the whole set. In the case of intersection, the resulting value is defined by uniontype which is one of the following: LAST (default), FIRST, MIN, MAX, COUNT, SUM, MEAN, RANGE." msgstr "" #. Tag: para -#: reference_raster.xml:7956 +#: reference_raster.xml:7959 #, no-c-format msgid "In order for rasters to be unioned, they most all have the same alignment. Use and for more details and help. One way to fix alignment issues is to use and use the same reference raster for alignment." msgstr "" #. Tag: para -#: reference_raster.xml:7960 +#: reference_raster.xml:7963 #, no-c-format msgid "Enhanced: 2.1.0 Improved Speed (fully C-Based)." msgstr "" #. Tag: para -#: reference_raster.xml:7961 +#: reference_raster.xml:7964 #, no-c-format msgid "Availability: 2.1.0 ST_Union(rast, unionarg) variant was introduced." msgstr "" #. Tag: para -#: reference_raster.xml:7962 +#: reference_raster.xml:7965 #, no-c-format msgid "Enhanced: 2.1.0 ST_Union(rast) (variant 1) unions all bands of all input rasters. Prior versions of PostGIS assumed the first band." msgstr "" #. Tag: para -#: reference_raster.xml:7963 +#: reference_raster.xml:7966 #, no-c-format msgid "Enhanced: 2.1.0 ST_Union(rast, uniontype) (variant 4) unions all bands of all input rasters." msgstr "" #. Tag: title -#: reference_raster.xml:7966 +#: reference_raster.xml:7969 #, no-c-format msgid "Examples: Reconstitute a single band chunked raster tile" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7967 +#: reference_raster.xml:7970 #, no-c-format msgid "" "-- this creates a single band from first band of raster tiles\n" @@ -9699,13 +9747,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:7971 reference_raster.xml:7975 +#: reference_raster.xml:7974 reference_raster.xml:7978 #, no-c-format msgid "Examples: Return a multi-band raster that is the union of tiles intersecting geometry" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7972 +#: reference_raster.xml:7975 #, no-c-format msgid "" "-- this creates a multi band raster collecting all the tiles that intersect a line\n" @@ -9718,13 +9766,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7976 +#: reference_raster.xml:7979 #, no-c-format msgid "Here we use the longer syntax if we only wanted a subset of bands or we want to change order of bands" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7977 +#: reference_raster.xml:7980 #, no-c-format msgid "" "-- this creates a multi band raster collecting all the tiles that intersect a line\n" @@ -9734,67 +9782,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7983 +#: reference_raster.xml:7986 #, no-c-format msgid ", , , , " msgstr "" #. Tag: title -#: reference_raster.xml:7996 +#: reference_raster.xml:7999 #, no-c-format msgid "Built-in Map Algebra Callback Functions" msgstr "" #. Tag: refname -#: reference_raster.xml:8000 +#: reference_raster.xml:8003 #, no-c-format msgid "ST_Distinct4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8001 +#: reference_raster.xml:8004 #, no-c-format msgid "Raster processing function that calculates the number of unique pixel values in a neighborhood." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:8005 +#: reference_raster.xml:8008 #, no-c-format msgid " float8 ST_Distinct4ma float8[][] matrix text nodatamode text[] VARIADIC args double precision ST_Distinct4ma double precision[][][] value integer[][] pos text[] VARIADIC userargs " msgstr "" #. Tag: para -#: reference_raster.xml:8025 +#: reference_raster.xml:8028 #, no-c-format msgid "Calculate the number of unique pixel values in a neighborhood of pixels." msgstr "" #. Tag: para -#: reference_raster.xml:8028 reference_raster.xml:8167 reference_raster.xml:8242 reference_raster.xml:8327 reference_raster.xml:8452 reference_raster.xml:8523 reference_raster.xml:8598 +#: reference_raster.xml:8031 reference_raster.xml:8170 reference_raster.xml:8245 reference_raster.xml:8330 reference_raster.xml:8455 reference_raster.xml:8526 reference_raster.xml:8601 #, no-c-format msgid "Variant 1 is a specialized callback function for use as a callback parameter to ." msgstr "" #. Tag: para -#: reference_raster.xml:8032 reference_raster.xml:8171 reference_raster.xml:8246 reference_raster.xml:8333 reference_raster.xml:8456 reference_raster.xml:8527 reference_raster.xml:8602 +#: reference_raster.xml:8035 reference_raster.xml:8174 reference_raster.xml:8249 reference_raster.xml:8336 reference_raster.xml:8459 reference_raster.xml:8530 reference_raster.xml:8605 #, no-c-format msgid "Variant 2 is a specialized callback function for use as a callback parameter to ." msgstr "" #. Tag: para -#: reference_raster.xml:8038 reference_raster.xml:8177 reference_raster.xml:8252 reference_raster.xml:8339 reference_raster.xml:8462 reference_raster.xml:8533 reference_raster.xml:8608 +#: reference_raster.xml:8041 reference_raster.xml:8180 reference_raster.xml:8255 reference_raster.xml:8342 reference_raster.xml:8465 reference_raster.xml:8536 reference_raster.xml:8611 #, no-c-format msgid "Use of Variant 1 is discouraged since has been deprecated as of 2.1.0." msgstr "" #. Tag: para -#: reference_raster.xml:8044 reference_raster.xml:8183 reference_raster.xml:8258 reference_raster.xml:8345 reference_raster.xml:8468 reference_raster.xml:8539 reference_raster.xml:8614 +#: reference_raster.xml:8047 reference_raster.xml:8186 reference_raster.xml:8261 reference_raster.xml:8348 reference_raster.xml:8471 reference_raster.xml:8542 reference_raster.xml:8617 #, no-c-format msgid "Enhanced: 2.1.0 Addition of Variant 2" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8050 +#: reference_raster.xml:8053 #, no-c-format msgid "" "SELECT \n" @@ -9811,103 +9859,103 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8056 reference_raster.xml:8480 reference_raster.xml:8551 +#: reference_raster.xml:8059 reference_raster.xml:8483 reference_raster.xml:8554 #, no-c-format msgid ", , , , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:8071 +#: reference_raster.xml:8074 #, no-c-format msgid "ST_InvDistWeight4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8072 +#: reference_raster.xml:8075 #, no-c-format msgid "Raster processing function that interpolates a pixel's value from the pixel's neighborhood." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:8077 +#: reference_raster.xml:8080 #, no-c-format msgid "double precision ST_InvDistWeight4ma double precision[][][] value integer[][] pos text[] VARIADIC userargs" msgstr "" #. Tag: para -#: reference_raster.xml:8089 +#: reference_raster.xml:8092 #, no-c-format msgid "Calculate an interpolated value for a pixel using the Inverse Distance Weighted method." msgstr "" #. Tag: para -#: reference_raster.xml:8091 +#: reference_raster.xml:8094 #, no-c-format msgid "There are two optional parameters that can be passed through userargs. The first parameter is the power factor (variable k in the equation below) between 0 and 1 used in the Inverse Distance Weighted equation. If not specified, default value is 1. The second parameter is the weight percentage applied only when the value of the pixel of interest is included with the interpolated value from the neighborhood. If not specified and the pixel of interest has a value, that value is returned." msgstr "" #. Tag: para -#: reference_raster.xml:8095 +#: reference_raster.xml:8098 #, no-c-format msgid "The basic inverse distance weight equation is:" msgstr "" #. Tag: para -#: reference_raster.xml:8104 +#: reference_raster.xml:8107 #, no-c-format msgid "k = power factor, a real number between 0 and 1" msgstr "" #. Tag: para -#: reference_raster.xml:8113 reference_raster.xml:8398 +#: reference_raster.xml:8116 reference_raster.xml:8401 #, no-c-format msgid "This function is a specialized callback function for use as a callback parameter to ." msgstr "" #. Tag: programlisting -#: reference_raster.xml:8121 reference_raster.xml:8406 +#: reference_raster.xml:8124 reference_raster.xml:8409 #, no-c-format msgid "-- NEEDS EXAMPLE" msgstr "" #. Tag: para -#: reference_raster.xml:8126 +#: reference_raster.xml:8129 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:8135 +#: reference_raster.xml:8138 #, no-c-format msgid "ST_Max4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8136 +#: reference_raster.xml:8139 #, no-c-format msgid "Raster processing function that calculates the maximum pixel value in a neighborhood." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:8140 +#: reference_raster.xml:8143 #, no-c-format msgid " float8 ST_Max4ma float8[][] matrix text nodatamode text[] VARIADIC args double precision ST_Max4ma double precision[][][] value integer[][] pos text[] VARIADIC userargs " msgstr "" #. Tag: para -#: reference_raster.xml:8160 +#: reference_raster.xml:8163 #, no-c-format msgid "Calculate the maximum pixel value in a neighborhood of pixels." msgstr "" #. Tag: para -#: reference_raster.xml:8162 reference_raster.xml:8237 reference_raster.xml:8322 reference_raster.xml:8447 reference_raster.xml:8593 +#: reference_raster.xml:8165 reference_raster.xml:8240 reference_raster.xml:8325 reference_raster.xml:8450 reference_raster.xml:8596 #, no-c-format msgid "For Variant 2, a substitution value for NODATA pixels can be specified by passing that value to userargs." msgstr "" #. Tag: programlisting -#: reference_raster.xml:8189 +#: reference_raster.xml:8192 #, no-c-format msgid "" "SELECT \n" @@ -9924,37 +9972,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8195 +#: reference_raster.xml:8198 #, no-c-format msgid ", , , , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:8210 +#: reference_raster.xml:8213 #, no-c-format msgid "ST_Mean4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8211 +#: reference_raster.xml:8214 #, no-c-format msgid "Raster processing function that calculates the mean pixel value in a neighborhood." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:8215 +#: reference_raster.xml:8218 #, no-c-format msgid " float8 ST_Mean4ma float8[][] matrix text nodatamode text[] VARIADIC args double precision ST_Mean4ma double precision[][][] value integer[][] pos text[] VARIADIC userargs " msgstr "" #. Tag: para -#: reference_raster.xml:8235 +#: reference_raster.xml:8238 #, no-c-format msgid "Calculate the mean pixel value in a neighborhood of pixels." msgstr "" #. Tag: programlisting -#: reference_raster.xml:8264 +#: reference_raster.xml:8267 #, no-c-format msgid "" "SELECT \n" @@ -9971,7 +10019,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8271 +#: reference_raster.xml:8274 #, no-c-format msgid "" "SELECT \n" @@ -9988,37 +10036,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8277 +#: reference_raster.xml:8280 #, no-c-format msgid ", , , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:8291 +#: reference_raster.xml:8294 #, no-c-format msgid "ST_Min4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8292 +#: reference_raster.xml:8295 #, no-c-format msgid "Raster processing function that calculates the minimum pixel value in a neighborhood." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:8298 +#: reference_raster.xml:8301 #, no-c-format msgid " float8 ST_Min4ma float8[][] matrix text nodatamode text[] VARIADIC args double precision ST_Min4ma double precision[][][] value integer[][] pos text[] VARIADIC userargs " msgstr "" #. Tag: para -#: reference_raster.xml:8318 +#: reference_raster.xml:8321 #, no-c-format msgid "Calculate the minimum pixel value in a neighborhood of pixels." msgstr "" #. Tag: programlisting -#: reference_raster.xml:8351 +#: reference_raster.xml:8354 #, no-c-format msgid "" "SELECT \n" @@ -10035,73 +10083,73 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8356 +#: reference_raster.xml:8359 #, no-c-format msgid ", , , , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:8371 +#: reference_raster.xml:8374 #, no-c-format msgid "ST_MinDist4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8372 +#: reference_raster.xml:8375 #, no-c-format msgid "Raster processing function that returns the minimum distance (in number of pixels) between the pixel of interest and a neighboring pixel with value." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:8377 +#: reference_raster.xml:8380 #, no-c-format msgid "double precision ST_MinDist4ma double precision[][][] value integer[][] pos text[] VARIADIC userargs" msgstr "" #. Tag: para -#: reference_raster.xml:8389 +#: reference_raster.xml:8392 #, no-c-format msgid "Return the shortest distance (in number of pixels) between the pixel of interest and the closest pixel with value in the neighborhood." msgstr "" #. Tag: para -#: reference_raster.xml:8392 +#: reference_raster.xml:8395 #, no-c-format msgid "The intent of this function is to provide an informative data point that helps infer the usefulness of the pixel of interest's interpolated value from . This function is particularly useful when the neighborhood is sparsely populated." msgstr "" #. Tag: para -#: reference_raster.xml:8411 +#: reference_raster.xml:8414 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:8420 +#: reference_raster.xml:8423 #, no-c-format msgid "ST_Range4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8421 +#: reference_raster.xml:8424 #, no-c-format msgid "Raster processing function that calculates the range of pixel values in a neighborhood." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:8425 +#: reference_raster.xml:8428 #, no-c-format msgid " float8 ST_Range4ma float8[][] matrix text nodatamode text[] VARIADIC args double precision ST_Range4ma double precision[][][] value integer[][] pos text[] VARIADIC userargs " msgstr "" #. Tag: para -#: reference_raster.xml:8445 +#: reference_raster.xml:8448 #, no-c-format msgid "Calculate the range of pixel values in a neighborhood of pixels." msgstr "" #. Tag: programlisting -#: reference_raster.xml:8474 +#: reference_raster.xml:8477 #, no-c-format msgid "" "SELECT \n" @@ -10118,31 +10166,31 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:8495 +#: reference_raster.xml:8498 #, no-c-format msgid "ST_StdDev4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8496 +#: reference_raster.xml:8499 #, no-c-format msgid "Raster processing function that calculates the standard deviation of pixel values in a neighborhood." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:8500 +#: reference_raster.xml:8503 #, no-c-format msgid " float8 ST_StdDev4ma float8[][] matrix text nodatamode text[] VARIADIC args double precision ST_StdDev4ma double precision[][][] value integer[][] pos text[] VARIADIC userargs " msgstr "" #. Tag: para -#: reference_raster.xml:8520 +#: reference_raster.xml:8523 #, no-c-format msgid "Calculate the standard deviation of pixel values in a neighborhood of pixels." msgstr "" #. Tag: programlisting -#: reference_raster.xml:8545 +#: reference_raster.xml:8548 #, no-c-format msgid "" "SELECT \n" @@ -10159,31 +10207,31 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:8566 +#: reference_raster.xml:8569 #, no-c-format msgid "ST_Sum4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8567 +#: reference_raster.xml:8570 #, no-c-format msgid "Raster processing function that calculates the sum of all pixel values in a neighborhood." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:8571 +#: reference_raster.xml:8574 #, no-c-format msgid " float8 ST_Sum4ma float8[][] matrix text nodatamode text[] VARIADIC args double precision ST_Sum4ma double precision[][][] value integer[][] pos text[] VARIADIC userargs " msgstr "" #. Tag: para -#: reference_raster.xml:8591 +#: reference_raster.xml:8594 #, no-c-format msgid "Calculate the sum of all pixel values in a neighborhood of pixels." msgstr "" #. Tag: programlisting -#: reference_raster.xml:8620 +#: reference_raster.xml:8623 #, no-c-format msgid "" "SELECT \n" @@ -10200,85 +10248,85 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8626 +#: reference_raster.xml:8629 #, no-c-format msgid ", , , , , , , " msgstr "" #. Tag: title -#: reference_raster.xml:8642 +#: reference_raster.xml:8645 #, no-c-format msgid "DEM (Elevation)" msgstr "" #. Tag: refname -#: reference_raster.xml:8646 +#: reference_raster.xml:8649 #, no-c-format msgid "ST_Aspect" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8647 +#: reference_raster.xml:8650 #, no-c-format msgid "Returns the aspect (in degrees by default) of an elevation raster band. Useful for analyzing terrain." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:8650 +#: reference_raster.xml:8653 #, no-c-format msgid " raster ST_Aspect raster rast integer band=1 text pixeltype=32BF text units=DEGREES boolean interpolate_nodata=FALSE raster ST_Aspect raster rast integer band raster customextent text pixeltype=32BF text units=DEGREES boolean interpolate_nodata=FALSE " msgstr "" #. Tag: para -#: reference_raster.xml:8675 +#: reference_raster.xml:8678 #, no-c-format msgid "Returns the aspect (in degrees by default) of an elevation raster band. Utilizes map algebra and applies the aspect equation to neighboring pixels." msgstr "" #. Tag: para -#: reference_raster.xml:8677 +#: reference_raster.xml:8680 #, no-c-format msgid "units indicates the units of the aspect. Possible values are: RADIANS, DEGREES (default)." msgstr "" #. Tag: para -#: reference_raster.xml:8681 +#: reference_raster.xml:8684 #, no-c-format msgid "When units = RADIANS, values are between 0 and 2 * pi radians measured clockwise from North." msgstr "" #. Tag: para -#: reference_raster.xml:8685 +#: reference_raster.xml:8688 #, no-c-format msgid "When units = DEGREES, values are between 0 and 360 degrees measured clockwise from North." msgstr "" #. Tag: para -#: reference_raster.xml:8689 +#: reference_raster.xml:8692 #, no-c-format msgid "If slope of pixel is zero, aspect of pixel is -1." msgstr "" #. Tag: para -#: reference_raster.xml:8694 +#: reference_raster.xml:8697 #, no-c-format msgid "For more information about Slope, Aspect and Hillshade, please refer to ESRI - How hillshade works and ERDAS Field Guide - Aspect Images." msgstr "" #. Tag: para -#: reference_raster.xml:8700 reference_raster.xml:8796 +#: reference_raster.xml:8703 reference_raster.xml:8799 #, no-c-format msgid "Enhanced: 2.1.0 Uses ST_MapAlgebra() and added optional interpolate_nodata function parameter" msgstr "" #. Tag: para -#: reference_raster.xml:8701 reference_raster.xml:8925 +#: reference_raster.xml:8704 reference_raster.xml:8928 #, no-c-format msgid "Changed: 2.1.0 In prior versions, return values were in radians. Now, return values default to degrees" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8706 +#: reference_raster.xml:8709 #, no-c-format msgid "" "WITH foo AS (\n" @@ -10307,13 +10355,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8712 reference_raster.xml:8809 reference_raster.xml:8937 +#: reference_raster.xml:8715 reference_raster.xml:8812 reference_raster.xml:8940 #, no-c-format msgid "Complete example of tiles of a coverage. This query only works with PostgreSQL 9.1 or higher." msgstr "" #. Tag: programlisting -#: reference_raster.xml:8714 +#: reference_raster.xml:8717 #, no-c-format msgid "" "WITH foo AS (\n" @@ -10345,79 +10393,79 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8719 +#: reference_raster.xml:8722 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:8732 +#: reference_raster.xml:8735 #, no-c-format msgid "ST_HillShade" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8733 +#: reference_raster.xml:8736 #, no-c-format msgid "Returns the hypothetical illumination of an elevation raster band using provided azimuth, altitude, brightness and scale inputs." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:8736 +#: reference_raster.xml:8739 #, no-c-format msgid " raster ST_HillShade raster rast integer band=1 text pixeltype=32BF double precision azimuth=315 double precision altitude=45 double precision max_bright=255 double precision scale=1.0 boolean interpolate_nodata=FALSE raster ST_HillShade raster rast integer band raster customextent text pixeltype=32BF double precision azimuth=315 double precision altitude=45 double precision max_bright=255 double precision scale=1.0 boolean interpolate_nodata=FALSE " msgstr "" #. Tag: para -#: reference_raster.xml:8767 +#: reference_raster.xml:8770 #, no-c-format msgid "Returns the hypothetical illumination of an elevation raster band using the azimuth, altitude, brightness, and scale inputs. Utilizes map algebra and applies the hill shade equation to neighboring pixels. Return pixel values are between 0 and 255." msgstr "" #. Tag: para -#: reference_raster.xml:8769 +#: reference_raster.xml:8772 #, no-c-format msgid "azimuth is a value between 0 and 360 degrees measured clockwise from North." msgstr "" #. Tag: para -#: reference_raster.xml:8773 +#: reference_raster.xml:8776 #, no-c-format msgid "altitude is a value between 0 and 90 degrees where 0 degrees is at the horizon and 90 degrees is directly overhead." msgstr "" #. Tag: para -#: reference_raster.xml:8777 +#: reference_raster.xml:8780 #, no-c-format msgid "max_bright is a value between 0 and 255 with 0 as no brightness and 255 as max brightness." msgstr "" #. Tag: para -#: reference_raster.xml:8781 reference_raster.xml:8909 +#: reference_raster.xml:8784 reference_raster.xml:8912 #, no-c-format msgid "scale is the ratio of vertical units to horizontal. For Feet:LatLon use scale=370400, for Meters:LatLon use scale=111120." msgstr "" #. Tag: para -#: reference_raster.xml:8785 +#: reference_raster.xml:8788 #, no-c-format msgid "If interpolate_nodata is TRUE, values for NODATA pixels from the input raster will be interpolated using before computing the hillshade illumination." msgstr "" #. Tag: para -#: reference_raster.xml:8790 +#: reference_raster.xml:8793 #, no-c-format msgid "For more information about Hillshade, please refer to How hillshade works." msgstr "" #. Tag: para -#: reference_raster.xml:8797 +#: reference_raster.xml:8800 #, no-c-format msgid "Changed: 2.1.0 In prior versions, azimuth and altitude were expressed in radians. Now, azimuth and altitude are expressed in degrees" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8803 +#: reference_raster.xml:8806 #, no-c-format msgid "" "WITH foo AS (\n" @@ -10446,7 +10494,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8811 +#: reference_raster.xml:8814 #, no-c-format msgid "" "WITH foo AS (\n" @@ -10478,97 +10526,97 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8816 +#: reference_raster.xml:8819 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:8829 +#: reference_raster.xml:8832 #, no-c-format msgid "ST_Roughness" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8830 +#: reference_raster.xml:8833 #, no-c-format msgid "Returns a raster with the calculated \"roughness\" of a DEM." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:8835 +#: reference_raster.xml:8838 #, no-c-format msgid "raster ST_Roughness raster rast integer nband raster customextent text pixeltype=\"32BF\" boolean interpolate_nodata=FALSE " msgstr "" #. Tag: para -#: reference_raster.xml:8848 +#: reference_raster.xml:8851 #, no-c-format msgid "Calculates the \"roughness\" of a DEM, by subtracting the maximum from the minimum for a given area." msgstr "" #. Tag: programlisting -#: reference_raster.xml:8854 reference_raster.xml:8987 reference_raster.xml:9038 +#: reference_raster.xml:8857 reference_raster.xml:8990 reference_raster.xml:9041 #, no-c-format msgid "-- needs examples" msgstr "" #. Tag: para -#: reference_raster.xml:8859 +#: reference_raster.xml:8862 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:8872 +#: reference_raster.xml:8875 #, no-c-format msgid "ST_Slope" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8873 +#: reference_raster.xml:8876 #, no-c-format msgid "Returns the slope (in degrees by default) of an elevation raster band. Useful for analyzing terrain." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:8876 +#: reference_raster.xml:8879 #, no-c-format msgid " raster ST_Slope raster rast integer nband=1 text pixeltype=32BF text units=DEGREES double precision scale=1.0 boolean interpolate_nodata=FALSE raster ST_Slope raster rast integer nband raster customextent text pixeltype=32BF text units=DEGREES double precision scale=1.0 boolean interpolate_nodata=FALSE " msgstr "" #. Tag: para -#: reference_raster.xml:8903 +#: reference_raster.xml:8906 #, no-c-format msgid "Returns the slope (in degrees by default) of an elevation raster band. Utilizes map algebra and applies the slope equation to neighboring pixels." msgstr "" #. Tag: para -#: reference_raster.xml:8905 +#: reference_raster.xml:8908 #, no-c-format msgid "units indicates the units of the slope. Possible values are: RADIANS, DEGREES (default), PERCENT." msgstr "" #. Tag: para -#: reference_raster.xml:8913 +#: reference_raster.xml:8916 #, no-c-format msgid "If interpolate_nodata is TRUE, values for NODATA pixels from the input raster will be interpolated using before computing the surface slope." msgstr "" #. Tag: para -#: reference_raster.xml:8918 +#: reference_raster.xml:8921 #, no-c-format msgid "For more information about Slope, Aspect and Hillshade, please refer to ESRI - How hillshade works and ERDAS Field Guide - Slope Images." msgstr "" #. Tag: para -#: reference_raster.xml:8924 +#: reference_raster.xml:8927 #, no-c-format msgid "Enhanced: 2.1.0 Uses ST_MapAlgebra() and added optional units, scale, interpolate_nodata function parameters" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8931 +#: reference_raster.xml:8934 #, no-c-format msgid "" "WITH foo AS (\n" @@ -10599,7 +10647,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8939 +#: reference_raster.xml:8942 #, no-c-format msgid "" "WITH foo AS (\n" @@ -10631,121 +10679,121 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8944 +#: reference_raster.xml:8947 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:8957 +#: reference_raster.xml:8960 #, no-c-format msgid "ST_TPI" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8958 +#: reference_raster.xml:8961 #, no-c-format msgid "Returns a raster with the calculated Topographic Position Index." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:8963 +#: reference_raster.xml:8966 #, no-c-format msgid "raster ST_TPI raster rast integer nband raster customextent text pixeltype=\"32BF\" boolean interpolate_nodata=FALSE " msgstr "" #. Tag: para -#: reference_raster.xml:8977 +#: reference_raster.xml:8980 #, no-c-format msgid "Calculates the Topographic Position Index, which is defined as the folcal mean with radius of one minus the center cell." msgstr "" #. Tag: para -#: reference_raster.xml:8980 reference_raster.xml:9030 +#: reference_raster.xml:8983 reference_raster.xml:9033 #, no-c-format msgid "This function only supports a focalmean radius of one." msgstr "" #. Tag: para -#: reference_raster.xml:8992 +#: reference_raster.xml:8995 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: refname -#: reference_raster.xml:9005 +#: reference_raster.xml:9008 #, no-c-format msgid "ST_TRI" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9006 +#: reference_raster.xml:9009 #, no-c-format msgid "Returns a raster with the calculated Terrain Ruggedness Index." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:9011 +#: reference_raster.xml:9014 #, no-c-format msgid "raster ST_TRI raster rast integer nband raster customextent text pixeltype=\"32BF\" boolean interpolate_nodata=FALSE " msgstr "" #. Tag: para -#: reference_raster.xml:9025 +#: reference_raster.xml:9028 #, no-c-format msgid "Terrain Ruggedness Index is calculated by comparing a central pixel with its neighbors, taking the absolute values of the differences, and averaging the result." msgstr "" #. Tag: para -#: reference_raster.xml:9043 +#: reference_raster.xml:9046 #, no-c-format msgid ", , , , , " msgstr "" #. Tag: title -#: reference_raster.xml:9057 +#: reference_raster.xml:9060 #, no-c-format msgid "Raster to Geometry" msgstr "" #. Tag: refname -#: reference_raster.xml:9061 +#: reference_raster.xml:9064 #, no-c-format msgid "Box3D" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9062 +#: reference_raster.xml:9065 #, no-c-format msgid "Returns the box 3d representation of the enclosing box of the raster." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:9067 +#: reference_raster.xml:9070 #, no-c-format msgid "box3d Box3D raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:9077 +#: reference_raster.xml:9080 #, no-c-format msgid "Returns the box representing the extent of the raster." msgstr "" #. Tag: para -#: reference_raster.xml:9078 +#: reference_raster.xml:9081 #, no-c-format msgid "The polygon is defined by the corner points of the bounding box ((MINX, MINY), (MAXX, MAXY))" msgstr "" #. Tag: para -#: reference_raster.xml:9082 +#: reference_raster.xml:9085 #, no-c-format msgid "Changed: 2.0.0 In pre-2.0 versions, there used to be a box2d instead of box3d. Since box2d is a deprecated type, this was changed to box3d." msgstr "" #. Tag: programlisting -#: reference_raster.xml:9088 +#: reference_raster.xml:9091 #, no-c-format msgid "" "SELECT\n" @@ -10760,43 +10808,43 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:9101 +#: reference_raster.xml:9104 #, no-c-format msgid "ST_ConvexHull" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9102 +#: reference_raster.xml:9105 #, no-c-format msgid "Return the convex hull geometry of the raster including pixel values equal to BandNoDataValue. For regular shaped and non-skewed rasters, this gives the same result as ST_Envelope so only useful for irregularly shaped or skewed rasters." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:9109 +#: reference_raster.xml:9112 #, no-c-format msgid "geometry ST_ConvexHull raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:9119 +#: reference_raster.xml:9122 #, no-c-format msgid "Return the convex hull geometry of the raster including the NoDataBandValue band pixels. For regular shaped and non-skewed rasters, this gives more or less the same result as ST_Envelope so only useful for irregularly shaped or skewed rasters." msgstr "" #. Tag: para -#: reference_raster.xml:9123 +#: reference_raster.xml:9126 #, no-c-format msgid "ST_Envelope floors the coordinates and hence add a little buffer around the raster so the answer is subtly different from ST_ConvexHull which does not floor." msgstr "" #. Tag: para -#: reference_raster.xml:9130 +#: reference_raster.xml:9133 #, no-c-format msgid "Refer to PostGIS Raster Specification for a diagram of this." msgstr "" #. Tag: programlisting -#: reference_raster.xml:9131 +#: reference_raster.xml:9134 #, no-c-format msgid "" "-- Note envelope and convexhull are more or less the same\n" @@ -10810,7 +10858,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:9132 +#: reference_raster.xml:9135 #, no-c-format msgid "" "-- now we skew the raster \n" @@ -10826,67 +10874,67 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9138 +#: reference_raster.xml:9141 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_raster.xml:9149 +#: reference_raster.xml:9152 #, no-c-format msgid "ST_DumpAsPolygons" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9150 +#: reference_raster.xml:9153 #, no-c-format msgid "Returns a set of geomval (geom,val) rows, from a given raster band. If no band number is specified, band num defaults to 1." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:9155 +#: reference_raster.xml:9158 #, no-c-format msgid "setof geomval ST_DumpAsPolygons raster rast integer band_num=1 boolean exclude_nodata_value=TRUE" msgstr "" #. Tag: para -#: reference_raster.xml:9166 +#: reference_raster.xml:9169 #, no-c-format msgid "This is a set-returning function (SRF). It returns a set of geomval rows, formed by a geometry (geom) and a pixel band value (val). Each polygon is the union of all pixels for that band that have the same pixel value denoted by val." msgstr "" #. Tag: para -#: reference_raster.xml:9170 +#: reference_raster.xml:9173 #, no-c-format msgid "ST_DumpAsPolygon is useful for polygonizing rasters. It is the reverse of a GROUP BY in that it creates new rows. For example it can be used to expand a single raster into multiple POLYGONS/MULTIPOLYGONS." msgstr "" #. Tag: para -#: reference_raster.xml:9174 +#: reference_raster.xml:9177 #, no-c-format msgid "Availability: Requires GDAL 1.7 or higher." msgstr "" #. Tag: para -#: reference_raster.xml:9175 +#: reference_raster.xml:9178 #, no-c-format msgid "If there is a no data value set for a band, pixels with that value will not be returned." msgstr "" #. Tag: para -#: reference_raster.xml:9176 +#: reference_raster.xml:9179 #, no-c-format msgid "If you only care about count of pixels with a given value in a raster, it is faster to use ." msgstr "" #. Tag: para -#: reference_raster.xml:9178 +#: reference_raster.xml:9181 #, no-c-format msgid "This is different than ST_PixelAsPolygons where one geometry is returned for each pixel regardless of pixel value." msgstr "" #. Tag: programlisting -#: reference_raster.xml:9186 +#: reference_raster.xml:9189 #, no-c-format msgid "" "SELECT val, ST_AsText(geom) As geomwkt\n" @@ -10911,43 +10959,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9191 +#: reference_raster.xml:9194 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_raster.xml:9202 +#: reference_raster.xml:9205 #, no-c-format msgid "ST_Envelope" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9203 +#: reference_raster.xml:9206 #, no-c-format msgid "Returns the polygon representation of the extent of the raster." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:9208 +#: reference_raster.xml:9211 #, no-c-format msgid "geometry ST_Envelope raster rast" msgstr "" #. Tag: para -#: reference_raster.xml:9218 +#: reference_raster.xml:9221 #, no-c-format msgid "Returns the polygon representation of the extent of the raster in spatial coordinate units defined by srid. It is a float8 minimum bounding box represented as a polygon." msgstr "" #. Tag: para -#: reference_raster.xml:9220 +#: reference_raster.xml:9223 #, no-c-format msgid "The polygon is defined by the corner points of the bounding box ((MINX, MINY), (MINX, MAXY), (MAXX, MAXY), (MAXX, MINY), (MINX, MINY))" msgstr "" #. Tag: programlisting -#: reference_raster.xml:9232 +#: reference_raster.xml:9235 #, no-c-format msgid "" "SELECT rid, ST_AsText(ST_Envelope(rast)) As envgeomwkt\n" @@ -10961,37 +11009,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9237 +#: reference_raster.xml:9240 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:9247 +#: reference_raster.xml:9250 #, no-c-format msgid "ST_MinConvexHull" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9248 +#: reference_raster.xml:9251 #, no-c-format msgid "Return the convex hull geometry of the raster excluding NODATA pixels." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:9255 +#: reference_raster.xml:9258 #, no-c-format msgid "geometry ST_MinConvexHull raster rast integer nband=NULL" msgstr "" #. Tag: para -#: reference_raster.xml:9266 +#: reference_raster.xml:9269 #, no-c-format msgid "Return the convex hull geometry of the raster excluding NODATA pixels. If nband is NULL, all bands of the raster are considered." msgstr "" #. Tag: programlisting -#: reference_raster.xml:9275 +#: reference_raster.xml:9278 #, no-c-format msgid "" "WITH foo AS (\n" @@ -11039,49 +11087,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9280 +#: reference_raster.xml:9283 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_raster.xml:9291 +#: reference_raster.xml:9294 #, no-c-format msgid "ST_Polygon" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9292 +#: reference_raster.xml:9295 #, no-c-format msgid "Returns a multipolygon geometry formed by the union of pixels that have a pixel value that is not no data value. If no band number is specified, band num defaults to 1." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:9297 +#: reference_raster.xml:9300 #, no-c-format msgid "geometry ST_Polygon raster rast integer band_num=1" msgstr "" #. Tag: para -#: reference_raster.xml:9307 +#: reference_raster.xml:9310 #, no-c-format msgid "Availability: 0.1.6 Requires GDAL 1.7 or higher." msgstr "" #. Tag: para -#: reference_raster.xml:9308 +#: reference_raster.xml:9311 #, no-c-format msgid "Enhanced: 2.1.0 Improved Speed (fully C-Based) and the returning multipolygon is ensured to be valid." msgstr "" #. Tag: para -#: reference_raster.xml:9309 +#: reference_raster.xml:9312 #, no-c-format msgid "Changed: 2.1.0 In prior versions would sometimes return a polygon, changed to always return multipolygon." msgstr "" #. Tag: programlisting -#: reference_raster.xml:9314 +#: reference_raster.xml:9317 #, no-c-format msgid "" "-- by default no data band value is 0 or not set, so polygon will return a square polygon \n" @@ -11125,43 +11173,43 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:9331 +#: reference_raster.xml:9334 #, no-c-format msgid "Raster Operators" msgstr "" #. Tag: refname -#: reference_raster.xml:9334 +#: reference_raster.xml:9337 #, no-c-format msgid "&&" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9336 +#: reference_raster.xml:9339 #, no-c-format msgid "Returns TRUE if A's bounding box intersects B's bounding box." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:9340 +#: reference_raster.xml:9343 #, no-c-format msgid " boolean && raster A raster B boolean && raster A geometry B boolean && geometry B raster A " msgstr "" #. Tag: para -#: reference_raster.xml:9382 +#: reference_raster.xml:9385 #, no-c-format msgid "The && operator returns TRUE if the bounding box of raster/geometr A intersects the bounding box of raster/geometr B." msgstr "" #. Tag: para -#: reference_raster.xml:9384 reference_raster.xml:9636 reference_raster.xml:10646 reference_raster.xml:10747 reference_raster.xml:10840 +#: reference_raster.xml:9387 reference_raster.xml:9639 reference_raster.xml:10649 reference_raster.xml:10750 reference_raster.xml:10843 #, no-c-format msgid "This operand will make use of any indexes that may be available on the rasters." msgstr "" #. Tag: programlisting -#: reference_raster.xml:9393 +#: reference_raster.xml:9396 #, no-c-format msgid "" "SELECT A.rid As a_rid, B.rid As b_rid, A.rast && B.rast As intersect\n" @@ -11175,37 +11223,37 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:9399 +#: reference_raster.xml:9402 #, no-c-format msgid "&<" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9401 +#: reference_raster.xml:9404 #, no-c-format msgid "Returns TRUE if A's bounding box is to the left of B's." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:9406 +#: reference_raster.xml:9409 #, no-c-format msgid "boolean &< raster A raster B " msgstr "" #. Tag: para -#: reference_raster.xml:9427 +#: reference_raster.xml:9430 #, no-c-format msgid "The &< operator returns TRUE if the bounding box of raster A overlaps or is to the left of the bounding box of raster B, or more accurately, overlaps or is NOT to the right of the bounding box of raster B." msgstr "" #. Tag: para -#: reference_raster.xml:9431 reference_raster.xml:9476 +#: reference_raster.xml:9434 reference_raster.xml:9479 #, no-c-format msgid "This operand will make use of any indexes that may be available on the geometries." msgstr "" #. Tag: programlisting -#: reference_raster.xml:9438 +#: reference_raster.xml:9441 #, no-c-format msgid "" "SELECT A.rid As a_rid, B.rid As b_rid, A.rast &< B.rast As overleft\n" @@ -11225,31 +11273,31 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:9444 +#: reference_raster.xml:9447 #, no-c-format msgid "&>" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9446 +#: reference_raster.xml:9449 #, no-c-format msgid "Returns TRUE if A's bounding box is to the right of B's." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:9451 +#: reference_raster.xml:9454 #, no-c-format msgid "boolean &> raster A raster B " msgstr "" #. Tag: para -#: reference_raster.xml:9472 +#: reference_raster.xml:9475 #, no-c-format msgid "The &> operator returns TRUE if the bounding box of raster A overlaps or is to the right of the bounding box of raster B, or more accurately, overlaps or is NOT to the left of the bounding box of raster B." msgstr "" #. Tag: programlisting -#: reference_raster.xml:9483 +#: reference_raster.xml:9486 #, no-c-format msgid "" "SELECT A.rid As a_rid, B.rid As b_rid, A.rast &> B.rast As overright\n" @@ -11269,109 +11317,109 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:9489 +#: reference_raster.xml:9492 #, no-c-format msgid "=" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9491 +#: reference_raster.xml:9494 #, no-c-format msgid "Returns TRUE if A's bounding box is the same as B's. Uses double precision bounding box." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:9496 +#: reference_raster.xml:9499 #, no-c-format msgid "boolean = raster A raster B " msgstr "" #. Tag: para -#: reference_raster.xml:9517 +#: reference_raster.xml:9520 #, no-c-format msgid "The = operator returns TRUE if the bounding box of raster A is the same as the bounding box of raster B. PostgreSQL uses the =, <, and > operators defined for rasters to perform internal orderings and comparison of rasters (ie. in a GROUP BY or ORDER BY clause)." msgstr "" #. Tag: para -#: reference_raster.xml:9521 +#: reference_raster.xml:9524 #, no-c-format msgid "This operand will NOT make use of any indexes that may be available on the rasters. Use instead. This operator exists mostly so one can group by the raster column." msgstr "" #. Tag: refname -#: reference_raster.xml:9537 +#: reference_raster.xml:9540 #, no-c-format msgid "@" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9539 +#: reference_raster.xml:9542 #, no-c-format msgid "Returns TRUE if A's bounding box is contained by B's. Uses double precision bounding box." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:9543 +#: reference_raster.xml:9546 #, no-c-format msgid " boolean @ raster A raster B boolean @ geometry A raster B boolean @ raster B geometry A " msgstr "" #. Tag: para -#: reference_raster.xml:9586 +#: reference_raster.xml:9589 #, no-c-format msgid "The @ operator returns TRUE if the bounding box of raster/geometry A is contained by bounding box of raster/geometr B." msgstr "" #. Tag: para -#: reference_raster.xml:9589 reference_raster.xml:9709 +#: reference_raster.xml:9592 reference_raster.xml:9712 #, no-c-format msgid "This operand will use spatial indexes on the rasters." msgstr "" #. Tag: para -#: reference_raster.xml:9591 +#: reference_raster.xml:9594 #, no-c-format msgid "Availability: 2.0.0 raster @ raster, raster @ geometry introduced" msgstr "" #. Tag: para -#: reference_raster.xml:9592 +#: reference_raster.xml:9595 #, no-c-format msgid "Availability: 2.0.5 geometry @ raster introduced" msgstr "" #. Tag: refname -#: reference_raster.xml:9605 +#: reference_raster.xml:9608 #, no-c-format msgid "~=" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9607 +#: reference_raster.xml:9610 #, no-c-format msgid "Returns TRUE if A's bounding box is the same as B's." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:9612 +#: reference_raster.xml:9615 #, no-c-format msgid "boolean ~= raster A raster B " msgstr "" #. Tag: para -#: reference_raster.xml:9633 +#: reference_raster.xml:9636 #, no-c-format msgid "The ~= operator returns TRUE if the bounding box of raster A is the same as the bounding box of raster B." msgstr "" #. Tag: para -#: reference_raster.xml:9645 +#: reference_raster.xml:9648 #, no-c-format msgid "Very useful usecase is for taking two sets of single band rasters that are of the same chunk but represent different themes and creating a multi-band raster" msgstr "" #. Tag: programlisting -#: reference_raster.xml:9646 +#: reference_raster.xml:9649 #, no-c-format msgid "" "SELECT ST_AddBand(prec.rast, alt.rast) As new_rast\n" @@ -11379,85 +11427,85 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9651 +#: reference_raster.xml:9654 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:9657 +#: reference_raster.xml:9660 #, no-c-format msgid "~" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9659 +#: reference_raster.xml:9662 #, no-c-format msgid "Returns TRUE if A's bounding box is contains B's. Uses double precision bounding box." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:9663 +#: reference_raster.xml:9666 #, no-c-format msgid " boolean ~ raster A raster B boolean ~ geometry A raster B boolean ~ raster B geometry A " msgstr "" #. Tag: para -#: reference_raster.xml:9706 +#: reference_raster.xml:9709 #, no-c-format msgid "The ~ operator returns TRUE if the bounding box of raster/geometry A is contains bounding box of raster/geometr B." msgstr "" #. Tag: title -#: reference_raster.xml:9724 +#: reference_raster.xml:9727 #, no-c-format msgid "Raster and Raster Band Spatial Relationships" msgstr "" #. Tag: refname -#: reference_raster.xml:9728 +#: reference_raster.xml:9731 #, no-c-format msgid "ST_Contains" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9729 +#: reference_raster.xml:9732 #, no-c-format msgid "Return true if no points of raster rastB lie in the exterior of raster rastA and at least one point of the interior of rastB lies in the interior of rastA." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:9735 +#: reference_raster.xml:9738 #, no-c-format msgid " boolean ST_Contains raster rastA integer nbandA raster rastB integer nbandB boolean ST_Contains raster rastA raster rastB " msgstr "" #. Tag: para -#: reference_raster.xml:9774 +#: reference_raster.xml:9777 #, no-c-format msgid "Raster rastA contains rastB if and only if no points of rastB lie in the exterior of rastA and at least one point of the interior of rastB lies in the interior of rastA. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test." msgstr "" #. Tag: para -#: reference_raster.xml:9779 reference_raster.xml:9872 reference_raster.xml:9953 reference_raster.xml:10034 reference_raster.xml:10244 reference_raster.xml:10328 reference_raster.xml:10408 +#: reference_raster.xml:9782 reference_raster.xml:9875 reference_raster.xml:9956 reference_raster.xml:10037 reference_raster.xml:10247 reference_raster.xml:10331 reference_raster.xml:10411 #, no-c-format msgid "This function will make use of any indexes that may be available on the rasters." msgstr "" #. Tag: para -#: reference_raster.xml:9785 +#: reference_raster.xml:9788 #, no-c-format msgid "To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Contains(ST_Polygon(raster), geometry) or ST_Contains(geometry, ST_Polygon(raster))." msgstr "" #. Tag: para -#: reference_raster.xml:9791 +#: reference_raster.xml:9794 #, no-c-format msgid "ST_Contains() is the inverse of ST_Within(). So, ST_Contains(rastA, rastB) implies ST_Within(rastB, rastA)." msgstr "" #. Tag: programlisting -#: reference_raster.xml:9802 +#: reference_raster.xml:9805 #, no-c-format msgid "" "-- specified band numbers\n" @@ -11471,7 +11519,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:9804 +#: reference_raster.xml:9807 #, no-c-format msgid "" "-- no band numbers specified\n" @@ -11483,49 +11531,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9808 +#: reference_raster.xml:9811 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:9817 +#: reference_raster.xml:9820 #, no-c-format msgid "ST_ContainsProperly" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9818 +#: reference_raster.xml:9821 #, no-c-format msgid "Return true if rastB intersects the interior of rastA but not the boundary or exterior of rastA." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:9824 +#: reference_raster.xml:9827 #, no-c-format msgid " boolean ST_ContainsProperly raster rastA integer nbandA raster rastB integer nbandB boolean ST_ContainsProperly raster rastA raster rastB " msgstr "" #. Tag: para -#: reference_raster.xml:9863 +#: reference_raster.xml:9866 #, no-c-format msgid "Raster rastA contains properly rastB if rastB intersects the interior of rastA but not the boundary or exterior of rastA. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test." msgstr "" #. Tag: para -#: reference_raster.xml:9867 +#: reference_raster.xml:9870 #, no-c-format msgid "Raster rastA does not contain properly itself but does contain itself." msgstr "" #. Tag: para -#: reference_raster.xml:9878 +#: reference_raster.xml:9881 #, no-c-format msgid "To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_ContainsProperly(ST_Polygon(raster), geometry) or ST_ContainsProperly(geometry, ST_Polygon(raster))." msgstr "" #. Tag: programlisting -#: reference_raster.xml:9889 +#: reference_raster.xml:9892 #, no-c-format msgid "" "SELECT r1.rid, r2.rid, ST_ContainsProperly(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n" @@ -11537,43 +11585,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9893 +#: reference_raster.xml:9896 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:9902 +#: reference_raster.xml:9905 #, no-c-format msgid "ST_Covers" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9903 +#: reference_raster.xml:9906 #, no-c-format msgid "Return true if no points of raster rastB lie outside raster rastA." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:9909 +#: reference_raster.xml:9912 #, no-c-format msgid " boolean ST_Covers raster rastA integer nbandA raster rastB integer nbandB boolean ST_Covers raster rastA raster rastB " msgstr "" #. Tag: para -#: reference_raster.xml:9948 +#: reference_raster.xml:9951 #, no-c-format msgid "Raster rastA covers rastB if and only if no points of rastB lie in the exterior of rastA. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test." msgstr "" #. Tag: para -#: reference_raster.xml:9959 +#: reference_raster.xml:9962 #, no-c-format msgid "To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Covers(ST_Polygon(raster), geometry) or ST_Covers(geometry, ST_Polygon(raster))." msgstr "" #. Tag: programlisting -#: reference_raster.xml:9970 +#: reference_raster.xml:9973 #, no-c-format msgid "" "SELECT r1.rid, r2.rid, ST_Covers(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n" @@ -11585,43 +11633,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9974 +#: reference_raster.xml:9977 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:9983 +#: reference_raster.xml:9986 #, no-c-format msgid "ST_CoveredBy" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9984 +#: reference_raster.xml:9987 #, no-c-format msgid "Return true if no points of raster rastA lie outside raster rastB." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:9990 +#: reference_raster.xml:9993 #, no-c-format msgid " boolean ST_CoveredBy raster rastA integer nbandA raster rastB integer nbandB boolean ST_CoveredBy raster rastA raster rastB " msgstr "" #. Tag: para -#: reference_raster.xml:10029 +#: reference_raster.xml:10032 #, no-c-format msgid "Raster rastA is covered by rastB if and only if no points of rastA lie in the exterior of rastB. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test." msgstr "" #. Tag: para -#: reference_raster.xml:10040 +#: reference_raster.xml:10043 #, no-c-format msgid "To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_CoveredBy(ST_Polygon(raster), geometry) or ST_CoveredBy(geometry, ST_Polygon(raster))." msgstr "" #. Tag: programlisting -#: reference_raster.xml:10051 +#: reference_raster.xml:10054 #, no-c-format msgid "" "SELECT r1.rid, r2.rid, ST_CoveredBy(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n" @@ -11633,49 +11681,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10055 +#: reference_raster.xml:10058 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:10064 +#: reference_raster.xml:10067 #, no-c-format msgid "ST_Disjoint" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10065 +#: reference_raster.xml:10068 #, no-c-format msgid "Return true if raster rastA does not spatially intersect rastB." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10071 +#: reference_raster.xml:10074 #, no-c-format msgid " boolean ST_Disjoint raster rastA integer nbandA raster rastB integer nbandB boolean ST_Disjoint raster rastA raster rastB " msgstr "" #. Tag: para -#: reference_raster.xml:10110 +#: reference_raster.xml:10113 #, no-c-format msgid "Raster rastA and rastB are disjointed if they do not share any space together. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test." msgstr "" #. Tag: para -#: reference_raster.xml:10115 +#: reference_raster.xml:10118 #, no-c-format msgid "This function does NOT use any indexes." msgstr "" #. Tag: para -#: reference_raster.xml:10121 +#: reference_raster.xml:10124 #, no-c-format msgid "To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Disjoint(ST_Polygon(raster), geometry)." msgstr "" #. Tag: programlisting -#: reference_raster.xml:10132 +#: reference_raster.xml:10135 #, no-c-format msgid "" "-- rid = 1 has no bands, hence the NOTICE and the NULL value for st_disjoint\n" @@ -11689,7 +11737,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:10134 +#: reference_raster.xml:10137 #, no-c-format msgid "" "-- this time, without specifying band numbers\n" @@ -11702,43 +11750,43 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:10147 +#: reference_raster.xml:10150 #, no-c-format msgid "ST_Intersects" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10148 +#: reference_raster.xml:10151 #, no-c-format msgid "Return true if raster rastA spatially intersects raster rastB." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10152 +#: reference_raster.xml:10155 #, no-c-format msgid " boolean ST_Intersects raster rastA integer nbandA raster rastB integer nbandB boolean ST_Intersects raster rastA raster rastB boolean ST_Intersects raster rast integer nband geometry geommin boolean ST_Intersects raster rast geometry geommin integer nband=NULL boolean ST_Intersects geometry geommin raster rast integer nband=NULL " msgstr "" #. Tag: para -#: reference_raster.xml:10239 +#: reference_raster.xml:10242 #, no-c-format msgid "Return true if raster rastA spatially intersects raster rastB. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test." msgstr "" #. Tag: para -#: reference_raster.xml:10249 +#: reference_raster.xml:10252 #, no-c-format msgid "Enhanced: 2.0.0 support raster/raster intersects was introduced." msgstr "" #. Tag: para -#: reference_raster.xml:10254 +#: reference_raster.xml:10257 #, no-c-format msgid "Changed: 2.1.0 The behavior of the ST_Intersects(raster, geometry) variants changed to match that of ST_Intersects(geometry, raster)." msgstr "" #. Tag: programlisting -#: reference_raster.xml:10263 +#: reference_raster.xml:10266 #, no-c-format msgid "" "-- different bands of same raster\n" @@ -11750,43 +11798,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10268 +#: reference_raster.xml:10271 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:10277 +#: reference_raster.xml:10280 #, no-c-format msgid "ST_Overlaps" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10278 +#: reference_raster.xml:10281 #, no-c-format msgid "Return true if raster rastA and rastB intersect but one does not completely contain the other." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10284 +#: reference_raster.xml:10287 #, no-c-format msgid " boolean ST_Overlaps raster rastA integer nbandA raster rastB integer nbandB boolean ST_Overlaps raster rastA raster rastB " msgstr "" #. Tag: para -#: reference_raster.xml:10323 +#: reference_raster.xml:10326 #, no-c-format msgid "Return true if raster rastA spatially overlaps raster rastB. This means that rastA and rastB intersect but one does not completely contain the other. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test." msgstr "" #. Tag: para -#: reference_raster.xml:10334 +#: reference_raster.xml:10337 #, no-c-format msgid "To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Overlaps(ST_Polygon(raster), geometry)." msgstr "" #. Tag: programlisting -#: reference_raster.xml:10345 +#: reference_raster.xml:10348 #, no-c-format msgid "" "-- comparing different bands of same raster\n" @@ -11798,37 +11846,37 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:10357 +#: reference_raster.xml:10360 #, no-c-format msgid "ST_Touches" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10358 +#: reference_raster.xml:10361 #, no-c-format msgid "Return true if raster rastA and rastB have at least one point in common but their interiors do not intersect." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10364 +#: reference_raster.xml:10367 #, no-c-format msgid " boolean ST_Touches raster rastA integer nbandA raster rastB integer nbandB boolean ST_Touches raster rastA raster rastB " msgstr "" #. Tag: para -#: reference_raster.xml:10403 +#: reference_raster.xml:10406 #, no-c-format msgid "Return true if raster rastA spatially touches raster rastB. This means that rastA and rastB have at least one point in common but their interiors do not intersect. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test." msgstr "" #. Tag: para -#: reference_raster.xml:10414 +#: reference_raster.xml:10417 #, no-c-format msgid "To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Touches(ST_Polygon(raster), geometry)." msgstr "" #. Tag: programlisting -#: reference_raster.xml:10425 +#: reference_raster.xml:10428 #, no-c-format msgid "" "SELECT r1.rid, r2.rid, ST_Touches(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n" @@ -11840,49 +11888,49 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:10437 +#: reference_raster.xml:10440 #, no-c-format msgid "ST_SameAlignment" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10439 +#: reference_raster.xml:10442 #, no-c-format msgid "Returns true if rasters have same skew, scale, spatial ref, and offset (pixels can be put on same grid without cutting into pixels) and false if they don't with notice detailing issue." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10443 +#: reference_raster.xml:10446 #, no-c-format msgid " boolean ST_SameAlignment raster rastA raster rastB boolean ST_SameAlignment double precision ulx1 double precision uly1 double precision scalex1 double precision scaley1 double precision skewx1 double precision skewy1 double precision ulx2 double precision uly2 double precision scalex2 double precision scaley2 double precision skewx2 double precision skewy2 boolean ST_SameAlignment raster set rastfield " msgstr "" #. Tag: para -#: reference_raster.xml:10522 +#: reference_raster.xml:10525 #, no-c-format msgid "Non-Aggregate version (Variants 1 and 2): Returns true if the two rasters (either provided directly or made using the values for upperleft, scale, skew and srid) have the same scale, skew, srid and at least one of any of the four corners of any pixel of one raster falls on any corner of the grid of the other raster. Returns false if they don't and a NOTICE detailing the alignment issue." msgstr "" #. Tag: para -#: reference_raster.xml:10526 +#: reference_raster.xml:10529 #, no-c-format msgid "Aggregate version (Variant 3): From a set of rasters, returns true if all rasters in the set are aligned. The ST_SameAlignment() function is an \"aggregate\" function in the terminology of PostgreSQL. That means that it operates on rows of data, in the same way the SUM() and AVG() functions do." msgstr "" #. Tag: para -#: reference_raster.xml:10531 +#: reference_raster.xml:10534 #, no-c-format msgid "Enhanced: 2.1.0 addition of Aggegrate variant" msgstr "" #. Tag: title -#: reference_raster.xml:10535 +#: reference_raster.xml:10538 #, no-c-format msgid "Examples: Rasters" msgstr "" #. Tag: programlisting -#: reference_raster.xml:10537 +#: reference_raster.xml:10540 #, no-c-format msgid "" "SELECT ST_SameAlignment(\n" @@ -11896,7 +11944,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:10538 +#: reference_raster.xml:10541 #, no-c-format msgid "" "SELECT ST_SameAlignment(A.rast,b.rast)\n" @@ -11913,43 +11961,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10542 +#: reference_raster.xml:10545 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:10552 +#: reference_raster.xml:10555 #, no-c-format msgid "ST_NotSameAlignmentReason" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10553 +#: reference_raster.xml:10556 #, no-c-format msgid "Returns text stating if rasters are aligned and if not aligned, a reason why." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:10558 +#: reference_raster.xml:10561 #, no-c-format msgid "text ST_NotSameAlignmentReason raster rastA raster rastB" msgstr "" #. Tag: para -#: reference_raster.xml:10568 +#: reference_raster.xml:10571 #, no-c-format msgid "Returns text stating if rasters are aligned and if not aligned, a reason why." msgstr "" #. Tag: para -#: reference_raster.xml:10571 +#: reference_raster.xml:10574 #, no-c-format msgid "If there are several reasons why the rasters are not aligned, only one reason (the first test to fail) will be returned." msgstr "" #. Tag: programlisting -#: reference_raster.xml:10581 +#: reference_raster.xml:10584 #, no-c-format msgid "" "SELECT\n" @@ -11970,49 +12018,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10586 +#: reference_raster.xml:10589 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:10595 +#: reference_raster.xml:10598 #, no-c-format msgid "ST_Within" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10596 +#: reference_raster.xml:10599 #, no-c-format msgid "Return true if no points of raster rastA lie in the exterior of raster rastB and at least one point of the interior of rastA lies in the interior of rastB." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10602 +#: reference_raster.xml:10605 #, no-c-format msgid " boolean ST_Within raster rastA integer nbandA raster rastB integer nbandB boolean ST_Within raster rastA raster rastB " msgstr "" #. Tag: para -#: reference_raster.xml:10641 +#: reference_raster.xml:10644 #, no-c-format msgid "Raster rastA is within rastB if and only if no points of rastA lie in the exterior of rastB and at least one point of the interior of rastA lies in the interior of rastB. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test." msgstr "" #. Tag: para -#: reference_raster.xml:10652 +#: reference_raster.xml:10655 #, no-c-format msgid "To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Within(ST_Polygon(raster), geometry) or ST_Within(geometry, ST_Polygon(raster))." msgstr "" #. Tag: para -#: reference_raster.xml:10658 +#: reference_raster.xml:10661 #, no-c-format msgid "ST_Within() is the inverse of ST_Contains(). So, ST_Within(rastA, rastB) implies ST_Contains(rastB, rastA)." msgstr "" #. Tag: programlisting -#: reference_raster.xml:10669 +#: reference_raster.xml:10672 #, no-c-format msgid "" "SELECT r1.rid, r2.rid, ST_Within(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n" @@ -12024,49 +12072,49 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10673 +#: reference_raster.xml:10676 #, no-c-format msgid ", , , " msgstr "" #. Tag: refname -#: reference_raster.xml:10684 +#: reference_raster.xml:10687 #, no-c-format msgid "ST_DWithin" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10685 +#: reference_raster.xml:10688 #, no-c-format msgid "Return true if rasters rastA and rastB are within the specified distance of each other." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10691 +#: reference_raster.xml:10694 #, no-c-format msgid " boolean ST_DWithin raster rastA integer nbandA raster rastB integer nbandB double precision distance_of_srid boolean ST_DWithin raster rastA raster rastB double precision distance_of_srid " msgstr "" #. Tag: para -#: reference_raster.xml:10738 +#: reference_raster.xml:10741 #, no-c-format msgid "Return true if rasters rastA and rastB are within the specified distance of each other. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test." msgstr "" #. Tag: para -#: reference_raster.xml:10742 reference_raster.xml:10835 +#: reference_raster.xml:10745 reference_raster.xml:10838 #, no-c-format msgid "The distance is specified in units defined by the spatial reference system of the rasters. For this function to make sense, the source rasters must both be of the same coordinate projection, having the same SRID." msgstr "" #. Tag: para -#: reference_raster.xml:10753 +#: reference_raster.xml:10756 #, no-c-format msgid "To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_DWithin(ST_Polygon(raster), geometry)." msgstr "" #. Tag: programlisting -#: reference_raster.xml:10764 +#: reference_raster.xml:10767 #, no-c-format msgid "" "SELECT r1.rid, r2.rid, ST_DWithin(r1.rast, 1, r2.rast, 1, 3.14) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n" @@ -12078,43 +12126,43 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10768 +#: reference_raster.xml:10771 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:10777 +#: reference_raster.xml:10780 #, no-c-format msgid "ST_DFullyWithin" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10778 +#: reference_raster.xml:10781 #, no-c-format msgid "Return true if rasters rastA and rastB are fully within the specified distance of each other." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10784 +#: reference_raster.xml:10787 #, no-c-format msgid " boolean ST_DFullyWithin raster rastA integer nbandA raster rastB integer nbandB double precision distance_of_srid boolean ST_DFullyWithin raster rastA raster rastB double precision distance_of_srid " msgstr "" #. Tag: para -#: reference_raster.xml:10831 +#: reference_raster.xml:10834 #, no-c-format msgid "Return true if rasters rastA and rastB are fully within the specified distance of each other. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test." msgstr "" #. Tag: para -#: reference_raster.xml:10846 +#: reference_raster.xml:10849 #, no-c-format msgid "To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_DFullyWithin(ST_Polygon(raster), geometry)." msgstr "" #. Tag: programlisting -#: reference_raster.xml:10857 +#: reference_raster.xml:10860 #, no-c-format msgid "" "SELECT r1.rid, r2.rid, ST_DFullyWithin(r1.rast, 1, r2.rast, 1, 3.14) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n" @@ -12126,7 +12174,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10861 +#: reference_raster.xml:10864 #, no-c-format msgid ", " msgstr "" diff --git a/doc/po/templates/reference_sfcgal.xml.pot b/doc/po/templates/reference_sfcgal.xml.pot index b7560b04a..48ef01fd1 100644 --- a/doc/po/templates/reference_sfcgal.xml.pot +++ b/doc/po/templates/reference_sfcgal.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -23,101 +23,113 @@ 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 execute postgis/sfcgal.sql" +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;" msgstr "" #. Tag: title -#: reference_sfcgal.xml:15 +#: reference_sfcgal.xml:22 #, no-c-format msgid "SFCGAL Functions" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:18 +#: reference_sfcgal.xml:25 #, no-c-format msgid "postgis_sfcgal_version" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:20 +#: reference_sfcgal.xml:27 #, no-c-format msgid "Returns the version of SFCGAL in use" msgstr "" #. Tag: funcdef -#: reference_sfcgal.xml:26 +#: reference_sfcgal.xml:33 #, no-c-format msgid "text postgis_sfcgal_version" msgstr "" #. Tag: title -#: reference_sfcgal.xml:33 reference_sfcgal.xml:65 reference_sfcgal.xml:158 reference_sfcgal.xml:218 reference_sfcgal.xml:247 reference_sfcgal.xml:276 reference_sfcgal.xml:305 reference_sfcgal.xml:335 reference_sfcgal.xml:377 reference_sfcgal.xml:405 +#: 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:523 reference_sfcgal.xml:551 reference_sfcgal.xml:579 reference_sfcgal.xml:617 reference_sfcgal.xml:708 reference_sfcgal.xml:749 reference_sfcgal.xml:777 #, no-c-format msgid "Description" msgstr "" #. Tag: para -#: reference_sfcgal.xml:35 reference_sfcgal.xml:67 reference_sfcgal.xml:160 reference_sfcgal.xml:249 reference_sfcgal.xml:278 reference_sfcgal.xml:310 reference_sfcgal.xml:337 reference_sfcgal.xml:379 reference_sfcgal.xml:407 +#: 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:581 reference_sfcgal.xml:619 #, no-c-format msgid "Availability: 2.1.0" msgstr "" #. Tag: para -#: reference_sfcgal.xml:36 reference_sfcgal.xml:68 reference_sfcgal.xml:161 reference_sfcgal.xml:221 reference_sfcgal.xml:250 reference_sfcgal.xml:279 reference_sfcgal.xml:311 reference_sfcgal.xml:338 reference_sfcgal.xml:380 reference_sfcgal.xml:408 +#: 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:526 reference_sfcgal.xml:554 reference_sfcgal.xml:582 reference_sfcgal.xml:620 reference_sfcgal.xml:711 reference_sfcgal.xml:752 reference_sfcgal.xml:780 #, no-c-format msgid "&sfcgal_required;" msgstr "" #. Tag: para -#: reference_sfcgal.xml:37 reference_sfcgal.xml:69 reference_sfcgal.xml:162 reference_sfcgal.xml:222 reference_sfcgal.xml:251 reference_sfcgal.xml:280 reference_sfcgal.xml:312 reference_sfcgal.xml:339 reference_sfcgal.xml:381 reference_sfcgal.xml:409 +#: 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:527 reference_sfcgal.xml:555 reference_sfcgal.xml:583 reference_sfcgal.xml:621 reference_sfcgal.xml:712 reference_sfcgal.xml:753 reference_sfcgal.xml:781 #, no-c-format msgid "&Z_support;" msgstr "" #. Tag: para -#: reference_sfcgal.xml:38 reference_sfcgal.xml:70 reference_sfcgal.xml:163 reference_sfcgal.xml:223 reference_sfcgal.xml:252 reference_sfcgal.xml:281 reference_sfcgal.xml:340 reference_sfcgal.xml:382 reference_sfcgal.xml:410 +#: 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:528 reference_sfcgal.xml:556 reference_sfcgal.xml:584 reference_sfcgal.xml:622 reference_sfcgal.xml:713 reference_sfcgal.xml:754 reference_sfcgal.xml:782 #, no-c-format msgid "&P_support;" msgstr "" #. Tag: para -#: reference_sfcgal.xml:39 reference_sfcgal.xml:71 reference_sfcgal.xml:164 reference_sfcgal.xml:224 reference_sfcgal.xml:253 reference_sfcgal.xml:282 reference_sfcgal.xml:341 reference_sfcgal.xml:383 reference_sfcgal.xml:411 +#: 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:529 reference_sfcgal.xml:557 reference_sfcgal.xml:585 reference_sfcgal.xml:623 reference_sfcgal.xml:714 reference_sfcgal.xml:755 reference_sfcgal.xml:783 #, no-c-format msgid "&T_support;" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:47 +#: reference_sfcgal.xml:54 #, no-c-format msgid "ST_Extrude" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:49 +#: reference_sfcgal.xml:56 #, no-c-format msgid "Extrude a surface to a related volume" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:54 +#: reference_sfcgal.xml:61 #, no-c-format msgid "geometry ST_Extrude geometry geom float x float y float z" msgstr "" #. Tag: title -#: reference_sfcgal.xml:74 reference_sfcgal.xml:167 reference_sfcgal.xml:414 +#: reference_sfcgal.xml:81 reference_sfcgal.xml:174 reference_sfcgal.xml:240 reference_sfcgal.xml:388 reference_sfcgal.xml:588 reference_sfcgal.xml:626 #, no-c-format msgid "Examples" msgstr "" #. Tag: para -#: reference_sfcgal.xml:75 +#: reference_sfcgal.xml:82 #, no-c-format msgid "3D images were generated using the PostGIS and rendering in HTML using X3Dom HTML Javascript redering library." msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:82 +#: reference_sfcgal.xml:89 #, no-c-format msgid "" "SELECT ST_Buffer(ST_GeomFromText('POINT(100 90)'),\n" @@ -125,13 +137,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:88 +#: reference_sfcgal.xml:95 #, no-c-format msgid "Original octagon formed from buffering point" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:93 +#: reference_sfcgal.xml:100 #, no-c-format msgid "" "ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),\n" @@ -139,25 +151,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:99 +#: reference_sfcgal.xml:106 #, no-c-format msgid "Hexagon extruded 30 units along Z produces a PolyhedralSurfaceZ" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:107 +#: reference_sfcgal.xml:114 #, no-c-format msgid "SELECT ST_GeomFromText('LINESTRING(50 50, 100 90, 95 150)')" msgstr "" #. Tag: para -#: reference_sfcgal.xml:113 +#: reference_sfcgal.xml:120 #, no-c-format msgid "Original linestring" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:118 +#: reference_sfcgal.xml:125 #, no-c-format msgid "" "SELECT ST_Extrude(\n" @@ -165,169 +177,290 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:124 +#: reference_sfcgal.xml:131 #, no-c-format msgid "LineString Extruded along Z produces a PolyhedralSurfaceZ" msgstr "" #. Tag: title -#: reference_sfcgal.xml:134 +#: reference_sfcgal.xml:141 reference_sfcgal.xml:263 reference_sfcgal.xml:594 reference_sfcgal.xml:725 #, no-c-format msgid "See Also" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:143 +#: reference_sfcgal.xml:150 #, no-c-format msgid "ST_StraightSkeleton" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:145 +#: reference_sfcgal.xml:152 #, no-c-format msgid "Compute a straight skeleton from a geometry" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:150 +#: reference_sfcgal.xml:157 #, no-c-format msgid "geometry ST_StraightSkeleton geometry geom" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:168 +#: reference_sfcgal.xml:175 #, no-c-format msgid "SELECT ST_StraightSkeleton(ST_GeomFromText('POLYGON (( 190 190, 10 190, 10 10, 190 10, 190 20, 160 30, 60 30, 60 130, 190 140, 190 190 ))'));" msgstr "" #. Tag: para -#: reference_sfcgal.xml:179 reference_sfcgal.xml:453 +#: reference_sfcgal.xml:186 reference_sfcgal.xml:665 #, no-c-format msgid "Original polygon" msgstr "" #. Tag: para -#: reference_sfcgal.xml:188 +#: reference_sfcgal.xml:195 #, no-c-format msgid "Straight Skeleton of polygon" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:203 +#: reference_sfcgal.xml:209 +#, no-c-format +msgid "ST_ApproximateMedialAxis" +msgstr "" + +#. Tag: refpurpose +#: reference_sfcgal.xml:211 +#, no-c-format +msgid "Compute the approximate medial axis of an areal geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_sfcgal.xml:216 +#, no-c-format +msgid "geometry ST_ApproximateMedialAxis geometry geom" +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:226 +#, no-c-format +msgid "Return an approximate medial axis for the areal input based on its straight skeleton. Uses an SFCGAL specific API when built against a capable version (1.2.0+). Otherwise the function is just a wrapper around ST_StraightSkeleton (slower case)." +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:233 reference_sfcgal.xml:525 reference_sfcgal.xml:553 reference_sfcgal.xml:710 reference_sfcgal.xml:751 reference_sfcgal.xml:779 +#, no-c-format +msgid "Availability: 2.2.0" +msgstr "" + +#. Tag: programlisting +#: reference_sfcgal.xml:241 +#, no-c-format +msgid "SELECT ST_ApproximateMedialAxis(ST_GeomFromText('POLYGON (( 190 190, 10 190, 10 10, 190 10, 190 20, 160 30, 60 30, 60 130, 190 140, 190 190 ))'));" +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:252 +#, no-c-format +msgid "A polygon and its approximate medial axis" +msgstr "" + +#. Tag: refname +#: reference_sfcgal.xml:273 #, no-c-format msgid "ST_IsPlanar" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:205 +#: reference_sfcgal.xml:275 #, no-c-format msgid "Check if a surface is or not planar" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:210 +#: reference_sfcgal.xml:280 #, no-c-format msgid "boolean ST_IsPlanar geometry geom" msgstr "" #. Tag: para -#: reference_sfcgal.xml:220 +#: reference_sfcgal.xml:290 #, no-c-format msgid "Availability: 2.2.0: This was documented in 2.1.0 but got accidentally left out in 2.1 release." msgstr "" #. Tag: refname -#: reference_sfcgal.xml:232 +#: reference_sfcgal.xml:302 #, no-c-format msgid "ST_Orientation" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:234 +#: reference_sfcgal.xml:304 #, no-c-format msgid "Determine surface orientation" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:239 +#: reference_sfcgal.xml:309 #, no-c-format msgid "integer ST_Orientation geometry geom" msgstr "" +#. Tag: para +#: reference_sfcgal.xml:319 +#, no-c-format +msgid "The function only applies to polygons. It returns -1 if the polygon is counterclockwise oriented and 1 if the polygon is clockwise oriented." +msgstr "" + #. Tag: refname -#: reference_sfcgal.xml:261 +#: reference_sfcgal.xml:331 #, no-c-format msgid "ST_ForceLHR" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:263 +#: reference_sfcgal.xml:333 #, no-c-format msgid "Force LHR orientation" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:268 +#: reference_sfcgal.xml:338 #, no-c-format msgid "geometry ST_ForceLHR geometry geom" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:289 +#: reference_sfcgal.xml:359 #, no-c-format msgid "ST_MinkowskiSum" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:291 +#: reference_sfcgal.xml:361 #, no-c-format msgid "Performs Minkowski sum" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:296 +#: reference_sfcgal.xml:366 #, no-c-format msgid "geometry ST_MinkowskiSum geometry geom1 geometry geom2" msgstr "" #. Tag: para -#: reference_sfcgal.xml:307 +#: reference_sfcgal.xml:377 #, no-c-format msgid "This function performs a 2D minkowski sum of a point, line or polygon with a polygon." msgstr "" #. Tag: para -#: reference_sfcgal.xml:308 +#: reference_sfcgal.xml:378 +#, no-c-format +msgid "A minkowski sum of two geometries A and B is the set of all points that are the sum of any point in A and B. Minkowski sums are often used in motion planning and computer-aided design. More details on Wikipedia Minkowski addition." +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:379 #, no-c-format msgid "The first parameter can be any 2D geometry (point, linestring, polygon). If a 3D geometry is passed, it will be converted to 2D by forcing Z to 0, leading to possible cases of invalidity. The second parameter must be a 2D polygon." msgstr "" +#. Tag: para +#: reference_sfcgal.xml:381 +#, no-c-format +msgid "Implementation utilizes CGAL 2D Minkowskisum." +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:389 +#, no-c-format +msgid "Minkowski Sum of Linestring and circle polygon where Linestring cuts thru the circle" +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:401 reference_sfcgal.xml:436 +#, no-c-format +msgid "Before Summing" +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:413 +#, no-c-format +msgid "After summing" +msgstr "" + +#. Tag: programlisting +#: reference_sfcgal.xml:422 +#, no-c-format +msgid "" + "SELECT ST_MinkowskiSum(line, circle))\n" + "FROM (SELECT \n" + " ST_MakeLine(ST_MakePoint(10, 10),ST_MakePoint(100, 100)) As line,\n" + " ST_Buffer(ST_GeomFromText('POINT(50 50)'), 30) As circle) As foo;\n" + " \n" + "-- wkt --\n" + "MULTIPOLYGON(((30 59.9999999999999,30.5764415879031 54.1472903395161,32.2836140246614 48.5194970290472,35.0559116309237 43.3328930094119,38.7867965644036 38.7867965644035,43.332893009412 35.0559116309236,48.5194970290474 32.2836140246614,54.1472903395162 30.5764415879031,60.0000000000001 30,65.8527096604839 30.5764415879031,71.4805029709527 32.2836140246614,76.6671069905881 35.0559116309237,81.2132034355964 38.7867965644036,171.213203435596 128.786796564404,174.944088369076 133.332893009412,177.716385975339 138.519497029047,179.423558412097 144.147290339516,180 150,179.423558412097 155.852709660484,177.716385975339 161.480502970953,174.944088369076 166.667106990588,171.213203435596 171.213203435596,166.667106990588 174.944088369076,\n" + "161.480502970953 177.716385975339,155.852709660484 179.423558412097,150 180,144.147290339516 179.423558412097,138.519497029047 177.716385975339,133.332893009412 174.944088369076,128.786796564403 171.213203435596,38.7867965644035 81.2132034355963,35.0559116309236 76.667106990588,32.2836140246614 71.4805029709526,30.5764415879031 65.8527096604838,30 59.9999999999999)))" +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:424 +#, no-c-format +msgid "Minkowski Sum of a polygon and multipoint" +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:448 +#, no-c-format +msgid "After summing: polygon is duplicated and translated to position of points" +msgstr "" + +#. Tag: programlisting +#: reference_sfcgal.xml:457 +#, no-c-format +msgid "" + "SELECT ST_MinkowskiSum(mp, poly)\n" + "FROM (SELECT 'MULTIPOINT(25 50,70 25)'::geometry As mp,\n" + " 'POLYGON((130 150, 20 40, 50 60, 125 100, 130 150))'::geometry As poly\n" + " ) As foo\n" + "\n" + " \n" + "-- wkt --\n" + "MULTIPOLYGON(\n" + " ((70 115,100 135,175 175,225 225,70 115)),\n" + " ((120 65,150 85,225 125,275 175,120 65))\n" + " )" +msgstr "" + #. Tag: refname -#: reference_sfcgal.xml:319 +#: reference_sfcgal.xml:464 #, no-c-format msgid "ST_3DIntersection" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:321 +#: reference_sfcgal.xml:466 #, no-c-format msgid "Perform 3D intersection" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:326 +#: reference_sfcgal.xml:471 #, no-c-format msgid "geometry ST_3DIntersection geometry geom1 geometry geom2" msgstr "" #. Tag: title -#: reference_sfcgal.xml:345 +#: reference_sfcgal.xml:490 #, no-c-format msgid "Examples: 3D linestring and Polygon" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:346 +#: reference_sfcgal.xml:491 #, no-c-format msgid "" "SELECT ST_AsText(ST_3DIntersection(linestring, polygon)) As wkt\n" @@ -340,13 +473,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:348 +#: reference_sfcgal.xml:493 #, no-c-format msgid "Cube (closed Polyhedral Surface) and Polygon Z" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:349 +#: reference_sfcgal.xml:494 #, no-c-format msgid "" "SELECT ST_AsText(ST_3DIntersection(\n" @@ -358,19 +491,19 @@ msgid "" msgstr "" #. Tag: screen -#: reference_sfcgal.xml:350 +#: reference_sfcgal.xml:495 #, 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:352 +#: reference_sfcgal.xml:497 #, no-c-format msgid "Intersection of 2 solids that result in volumetric intersection is also a solid (ST_Dimension returns 3)" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:353 +#: reference_sfcgal.xml:498 #, no-c-format msgid "" "SELECT ST_AsText(ST_3DIntersection( ST_Extrude(ST_Buffer('POINT(10 20)'::geometry,10,1),0,0,30),\n" @@ -378,7 +511,7 @@ msgid "" msgstr "" #. Tag: screen -#: reference_sfcgal.xml:354 +#: reference_sfcgal.xml:499 #, no-c-format msgid "" "POLYHEDRALSURFACE Z (((13.3333333333333 13.3333333333333 10,20 20 0,20 20 10,13.3333333333333 13.3333333333333 10)),\n" @@ -398,49 +531,115 @@ msgid "" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:362 +#: reference_sfcgal.xml:507 +#, no-c-format +msgid "ST_3DDifference" +msgstr "" + +#. Tag: refpurpose +#: reference_sfcgal.xml:509 +#, no-c-format +msgid "Perform 3D difference" +msgstr "" + +#. Tag: funcprototype +#: reference_sfcgal.xml:514 +#, no-c-format +msgid "geometry ST_3DDifference geometry geom1 geometry geom2" +msgstr "" + +#. Tag: refname +#: reference_sfcgal.xml:535 +#, no-c-format +msgid "ST_3DUnion" +msgstr "" + +#. Tag: refpurpose +#: reference_sfcgal.xml:537 +#, no-c-format +msgid "Perform 3D union" +msgstr "" + +#. Tag: funcprototype +#: reference_sfcgal.xml:542 +#, no-c-format +msgid "geometry ST_3DUnion geometry geom1 geometry geom2" +msgstr "" + +#. Tag: refname +#: reference_sfcgal.xml:564 #, no-c-format msgid "ST_3DArea" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:364 +#: reference_sfcgal.xml:566 #, no-c-format -msgid "Computes area of 3D geometries" +msgid "Computes area of 3D surface geometries. Will return 0 for solids." msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:369 +#: reference_sfcgal.xml:571 #, no-c-format msgid "floatST_3DArea geometry geom1" msgstr "" +#. Tag: para +#: reference_sfcgal.xml:589 +#, no-c-format +msgid "Note: By default a PolyhedralSurface built from WKT is a surface geometry, not solid. It therefore has surface area. Once converted to a solid, no area." +msgstr "" + +#. Tag: programlisting +#: reference_sfcgal.xml:590 +#, no-c-format +msgid "" + "SELECT ST_3DArea(geom) As cube_surface_area, \n" + " ST_3DArea(ST_MakeSolid(geom)) As solid_surface_area\n" + " FROM (SELECT '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)) )'::geometry) As f(geom);\n" + " \n" + " cube_surface_area | solid_surface_area\n" + "-------------------+--------------------\n" + " 6 | 0" +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:596 +#, no-c-format +msgid ", , , " +msgstr "" + #. Tag: refname -#: reference_sfcgal.xml:390 +#: reference_sfcgal.xml:602 #, no-c-format msgid "ST_Tesselate" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:392 +#: reference_sfcgal.xml:604 #, no-c-format msgid "Perform surface Tesselation of a polygon or polyhedralsurface and returns as a TIN or collection of TINS" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:397 +#: reference_sfcgal.xml:609 #, no-c-format msgid "geometry ST_Tesselate geometry geom" msgstr "" #. Tag: para -#: reference_sfcgal.xml:406 +#: reference_sfcgal.xml:618 #, no-c-format msgid "Takes as input a surface such a MULTI(POLYGON) or POLYHEDRALSURFACE and returns a TIN representation via the process of tesselation using triangles." msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:420 +#: reference_sfcgal.xml:632 #, no-c-format msgid "" "SELECT ST_GeomFromText('POLYHEDRALSURFACE Z( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)), \n" @@ -450,13 +649,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:426 +#: reference_sfcgal.xml:638 #, no-c-format msgid "Original Cube" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:431 +#: reference_sfcgal.xml:643 #, no-c-format msgid "" "SELECT ST_Tesselate(ST_GeomFromText('POLYHEDRALSURFACE Z( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)), \n" @@ -466,13 +665,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:432 +#: reference_sfcgal.xml:644 #, no-c-format msgid "ST_AsText output:" msgstr "" #. Tag: screen -#: reference_sfcgal.xml:433 +#: reference_sfcgal.xml:645 #, 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" @@ -485,19 +684,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:439 +#: reference_sfcgal.xml:651 #, no-c-format msgid "Tesselated Cube with triangles colored" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:447 +#: reference_sfcgal.xml:659 #, no-c-format msgid "SELECT 'POLYGON (( 10 190, 10 70, 80 70, 80 130, 50 160, 120 160, 120 190, 10 190 ))'::geometry;" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:458 +#: reference_sfcgal.xml:670 #, no-c-format msgid "" "SELECT \n" @@ -505,13 +704,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:460 +#: reference_sfcgal.xml:672 #, no-c-format msgid "ST_AsText output" msgstr "" #. Tag: screen -#: reference_sfcgal.xml:461 +#: reference_sfcgal.xml:673 #, no-c-format msgid "" "TIN(((80 130,50 160,80 70,80 130)),((50 160,10 190,10 70,50 160)),\n" @@ -520,8 +719,98 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:467 +#: reference_sfcgal.xml:679 #, no-c-format msgid "Tesselated Polygon" msgstr "" +#. Tag: refname +#: reference_sfcgal.xml:693 +#, no-c-format +msgid "ST_Volume" +msgstr "" + +#. Tag: refpurpose +#: reference_sfcgal.xml:695 +#, no-c-format +msgid "Computes the volume of a 3D solid. If applied to surface (even closed) geometries will return 0." +msgstr "" + +#. Tag: funcprototype +#: reference_sfcgal.xml:700 +#, no-c-format +msgid "float ST_Volume geometry geom1" +msgstr "" + +#. Tag: title +#: reference_sfcgal.xml:718 +#, no-c-format +msgid "Example" +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:719 +#, no-c-format +msgid "When closed surfaces are created with WKT, they are treated as areal rather than solid. To make them solid, you need to use . Areal geometries have no volume. Here is an example to demonstrate." +msgstr "" + +#. Tag: programlisting +#: reference_sfcgal.xml:721 +#, no-c-format +msgid "" + "SELECT ST_Volume(geom) As cube_surface_vol, \n" + " ST_Volume(ST_MakeSolid(geom)) As solid_surface_vol\n" + " FROM (SELECT '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)) )'::geometry) As f(geom);\n" + " \n" + " cube_surface_vol | solid_surface_vol\n" + "------------------+-------------------\n" + " 0 | 1" +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:727 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_sfcgal.xml:734 +#, no-c-format +msgid "ST_MakeSolid" +msgstr "" + +#. Tag: refpurpose +#: reference_sfcgal.xml:736 +#, no-c-format +msgid "Cast the geometry into a solid. No check is performed. To obtain a valid solid, the input geometry must be a closed Polyhedral Surface or a closed TIN." +msgstr "" + +#. Tag: funcprototype +#: reference_sfcgal.xml:741 +#, no-c-format +msgid "geometryST_MakeSolid geometry geom1" +msgstr "" + +#. Tag: refname +#: reference_sfcgal.xml:762 +#, no-c-format +msgid "ST_IsSolid" +msgstr "" + +#. Tag: refpurpose +#: reference_sfcgal.xml:764 +#, no-c-format +msgid "Test if the geometry is a solid. No validity check is performed." +msgstr "" + +#. Tag: funcprototype +#: reference_sfcgal.xml:769 +#, no-c-format +msgid "booleanST_IsSolid geometry geom1" +msgstr "" + diff --git a/doc/po/templates/release_notes.xml.pot b/doc/po/templates/release_notes.xml.pot index 0ff11004d..640cba006 100644 --- a/doc/po/templates/release_notes.xml.pot +++ b/doc/po/templates/release_notes.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -27,5869 +27,6325 @@ msgid "Release Notes" msgstr "" #. Tag: title -#: release_notes.xml:6 +#: release_notes.xml:7 #, no-c-format msgid "Release 2.2.0" msgstr "" #. Tag: para -#: release_notes.xml:7 +#: release_notes.xml:8 +#, no-c-format +msgid "Release date: 2015/10/DD" +msgstr "" + +#. Tag: para +#: release_notes.xml:9 #, no-c-format -msgid "Release date: YYYY/MM/DD" +msgid "This is a new feature release, with new functions, improved performance, and other goodies." msgstr "" #. Tag: title -#: release_notes.xml:11 +#: release_notes.xml:11 release_notes.xml:297 release_notes.xml:756 release_notes.xml:956 release_notes.xml:1020 release_notes.xml:1317 #, no-c-format -msgid "Release 2.1.4" +msgid "New Features" msgstr "" #. Tag: para #: release_notes.xml:12 #, no-c-format -msgid "Release date: 2014-09-10" +msgid "Topology API in liblwgeom (Sandro Santilli / Regione Toscana - SITA)" msgstr "" #. Tag: para #: release_notes.xml:13 #, no-c-format -msgid "This is a bug fix and performance improvement release." +msgid "New lwgeom_unaryunion method in liblwgeom" msgstr "" -#. Tag: title -#: release_notes.xml:15 release_notes.xml:124 release_notes.xml:152 release_notes.xml:271 release_notes.xml:449 release_notes.xml:477 release_notes.xml:536 release_notes.xml:598 release_notes.xml:688 release_notes.xml:889 release_notes.xml:944 +#. Tag: para +#: release_notes.xml:14 #, no-c-format -msgid "Enhancements" +msgid "New lwgeom_linemerge method in liblwgeom" +msgstr "" + +#. Tag: para +#: release_notes.xml:15 +#, no-c-format +msgid "New lwgeom_is_simple method in liblwgeom" msgstr "" #. Tag: para #: release_notes.xml:16 #, no-c-format -msgid "#2745, Speedup ST_Simplify calls against points" +msgid "#3169, Add SFCGAL 1.1 support: add ST_3DDifference, ST_3DUnion, ST_Volume, ST_MakeSolid, ST_IsSolid (Vincent Mora / Oslandia)" msgstr "" #. Tag: para #: release_notes.xml:17 #, no-c-format -msgid "#2747, Support for GDAL 2.0" +msgid "#3169, ST_ApproximateMedialAxis (Sandro Santilli)" msgstr "" #. Tag: para #: release_notes.xml:18 #, no-c-format -msgid "#2749, Make rtpostgis_upgrade_20_21.sql ACID" +msgid "ST_CPAWithin (Sandro Santilli / Boundless)" msgstr "" #. Tag: para #: release_notes.xml:19 #, no-c-format -msgid "#2811, Do not specify index names when loading shapefiles/rasters" +msgid "Add |=| operator with CPA semantic and KNN support with PgSQL 9.5+ (Sandro Santilli / Boundless)" msgstr "" #. Tag: para #: release_notes.xml:20 #, no-c-format -msgid "#2829, Shortcut ST_Clip(raster) if geometry fully contains the raster and no NODATA specified" +msgid "#3131, KNN support for the geography type (Paul Ramsey / CartoDB)" +msgstr "" + +#. Tag: para +#: release_notes.xml:21 +#, no-c-format +msgid "#3023, ST_ClusterIntersecting / ST_ClusterWithin (Dan Baston)" msgstr "" #. Tag: para #: release_notes.xml:22 #, no-c-format -msgid "#2895, Raise cost of ST_ConvexHull(raster) to 300 for better query plans" +msgid "#2703, Exact KNN results for all geometry types, aka \"KNN re-check\" (Paul Ramsey / CartoDB)" msgstr "" -#. Tag: title -#: release_notes.xml:26 release_notes.xml:87 release_notes.xml:98 release_notes.xml:139 release_notes.xml:395 release_notes.xml:421 release_notes.xml:463 release_notes.xml:487 release_notes.xml:550 release_notes.xml:705 release_notes.xml:719 release_notes.xml:757 release_notes.xml:795 release_notes.xml:826 +#. Tag: para +#: release_notes.xml:23 #, no-c-format -msgid "Bug Fixes" +msgid "#1137, Allow a tolerance value in ST_RemoveRepeatedPoints (Paul Ramsey / CartoDB)" +msgstr "" + +#. Tag: para +#: release_notes.xml:24 +#, no-c-format +msgid "#3062, Allow passing M factor to ST_Scale (Sandro Santilli / Boundless)" +msgstr "" + +#. Tag: para +#: release_notes.xml:25 +#, no-c-format +msgid "#3139, ST_BoundingDiagonal (Sandro Santilli / Boundless)" +msgstr "" + +#. Tag: para +#: release_notes.xml:26 +#, no-c-format +msgid "#3129, ST_IsValidTrajectory (Sandro Santilli / Boundless)" msgstr "" #. Tag: para #: release_notes.xml:27 #, no-c-format -msgid "#2605, armel: _ST_Covers() returns true for point in hole" +msgid "#3128, ST_ClosestPointOfApproach (Sandro Santilli / Boundless)" msgstr "" #. Tag: para #: release_notes.xml:28 #, no-c-format -msgid "#2911, Fix output scale on ST_Rescale/ST_Resample/ST_Resize of rasters with scale 1/-1 and offset 0/0." +msgid "#3152, ST_DistanceCPA (Sandro Santilli / Boundless)" +msgstr "" + +#. Tag: para +#: release_notes.xml:29 +#, no-c-format +msgid "Canonical output for index key types" msgstr "" #. Tag: para #: release_notes.xml:30 #, no-c-format -msgid "Fix crash in ST_Union(raster)" +msgid "ST_SwapOrdinates (Sandro Santilli / Boundless)" msgstr "" #. Tag: para #: release_notes.xml:31 #, no-c-format -msgid "#2704, ST_GeomFromGML() does not work properly with array of gml:pos (Even Roualt)" +msgid "#2918, Use GeographicLib functions for geodetics (Mike Toews)" +msgstr "" + +#. Tag: para +#: release_notes.xml:32 +#, no-c-format +msgid "#3074, ST_Subdivide to break up large geometry (Paul Ramsey / CartoDB)" msgstr "" #. Tag: para #: release_notes.xml:33 #, no-c-format -msgid "#2708, updategeometrysrid doesn't update srid check when schema not specified. Patch from Marc Jansen" +msgid "#3040, KNN GiST index based centroid (<<->>) n-D distance operators (Sandro Santilli / Boundless)" +msgstr "" + +#. Tag: para +#: release_notes.xml:34 +#, no-c-format +msgid "Interruptibility API for liblwgeom (Sandro Santilli / CartoDB)" msgstr "" #. Tag: para #: release_notes.xml:35 #, no-c-format -msgid "#2720, lwpoly_add_ring should update maxrings after realloc" +msgid "#2939, ST_ClipByBox2D (Sandro Santilli / CartoDB)" msgstr "" #. Tag: para #: release_notes.xml:36 #, no-c-format -msgid "#2759, Fix postgis_restore.pl handling of multiline object comments embedding sql comments" +msgid "#2247, ST_Retile and ST_CreateOverview: in-db raster overviews creation (Sandro Santilli / Vizzuality)" +msgstr "" + +#. Tag: para +#: release_notes.xml:37 +#, no-c-format +msgid "#899, -m shp2pgsql attribute names mapping -m switch (Regina Obe / Sandro Santilli)" msgstr "" #. Tag: para #: release_notes.xml:38 #, no-c-format -msgid "#2774, fix undefined behavior in ptarray_calculate_gbox_geodetic - Fix potential memory fault in ST_MakeValid" +msgid "#1678, Added GUC postgis.gdal_datapath to specify GDAL config variable GDAL_DATA" +msgstr "" + +#. Tag: para +#: release_notes.xml:39 +#, no-c-format +msgid "#2843, Support reprojection on raster import (Sandro Santilli / Vizzuality)" msgstr "" #. Tag: para #: release_notes.xml:40 #, no-c-format -msgid "#2784, Fix handling of bogus argument to --with-sfcgal" +msgid "#2349, Support for encoded_polyline input/output (Kashif Rasul)" msgstr "" #. Tag: para #: release_notes.xml:41 #, no-c-format -msgid "#2772, Premature memory free in RASTER_getBandPath (ST_BandPath)" +msgid "#2159, report libjson version from postgis_full_version()" msgstr "" #. Tag: para #: release_notes.xml:42 #, no-c-format -msgid "#2755, Fix regressions tests against all versions of SFCGAL" +msgid "#2770, ST_MemSize(raster)" msgstr "" #. Tag: para #: release_notes.xml:43 #, no-c-format -msgid "#2775, lwline_from_lwmpoint leaks memory" +msgid "Add postgis_noop(raster)" msgstr "" #. Tag: para #: release_notes.xml:44 #, no-c-format -msgid "#2802, ST_MapAlgebra checks for valid callback function return value" +msgid "Added missing variants of ST_TPI(), ST_TRI() and ST_Roughness()" msgstr "" #. Tag: para #: release_notes.xml:45 #, no-c-format -msgid "#2803, ST_MapAlgebra handles no userarg and STRICT callback function" +msgid "Added GUC postgis.gdal_enabled_drivers to specify GDAL config variable GDAL_SKIP" msgstr "" #. Tag: para #: release_notes.xml:46 #, no-c-format -msgid "#2834, ST_Estimated_Extent and mixedCase table names (regression bug)" +msgid "Added GUC postgis.enable_outdb_rasters to enable access to rasters with out-db bands" msgstr "" #. Tag: para #: release_notes.xml:47 #, no-c-format -msgid "#2845, Bad geometry created from ST_AddPoint" +msgid "#2387, address_standardizer extension as part of PostGIS (Stephen Woodbridge / imaptools.com, Walter Sinclair, Regina Obe)" msgstr "" #. Tag: para #: release_notes.xml:48 #, no-c-format -msgid "#2870, Binary insert into geography column results geometry being inserted" +msgid "#2816, address_standardizer_data_us extension provides reference lex,gaz,rules for address_standardizer (Stephen Woodbridge / imaptools.com, Walter Sinclair, Regina Obe)" msgstr "" #. Tag: para #: release_notes.xml:49 #, no-c-format -msgid "#2872, make install builds documentation (Greg Troxell)" +msgid "#2341, New mask parameter for ST_MapAlgebra" msgstr "" #. Tag: para #: release_notes.xml:50 #, no-c-format -msgid "#2819, find isfinite or replacement on Centos5 / Solaris" +msgid "#2397, read encoding info automatically in shapefile loader" msgstr "" #. Tag: para #: release_notes.xml:51 #, no-c-format -msgid "#2899, geocode limit 1 not returning best answer (tiger geocoder)" +msgid "#2430, ST_ForceCurve" msgstr "" #. Tag: para #: release_notes.xml:52 #, no-c-format -msgid "#2903, Unable to compile on FreeBSD" +msgid "#2565, ST_SummaryStatsAgg()" msgstr "" #. Tag: para #: release_notes.xml:53 #, no-c-format -msgid "#2927 reverse_geocode not filling in direction prefix (tiger geocoder) get rid of deprecated ST_Line_Locate_Point called" +msgid "#2567, ST_CountAgg()" +msgstr "" + +#. Tag: para +#: release_notes.xml:54 +#, no-c-format +msgid "#2632, ST_AsGML() support for curved features" +msgstr "" + +#. Tag: para +#: release_notes.xml:55 +#, no-c-format +msgid "#2652, Add --upgrade-path switch to run_test.pl" +msgstr "" + +#. Tag: para +#: release_notes.xml:56 +#, no-c-format +msgid "#2754, sfcgal wrapped as an extension" +msgstr "" + +#. Tag: para +#: release_notes.xml:57 +#, no-c-format +msgid "#2227, Simplification with Visvalingam-Whyatt algorithm ST_SimplifyVW, ST_SetEffectiveArea (Nicklas Avén)" +msgstr "" + +#. Tag: para +#: release_notes.xml:58 +#, no-c-format +msgid "Functions to encode and decode TWKB ST_AsTWKB, ST_GeomFromTWKB (Paul Ramsey / Nicklas Avén / CartoDB)" +msgstr "" + +#. Tag: title +#: release_notes.xml:61 release_notes.xml:89 release_notes.xml:110 release_notes.xml:219 release_notes.xml:247 release_notes.xml:366 release_notes.xml:544 release_notes.xml:572 release_notes.xml:631 release_notes.xml:693 release_notes.xml:783 release_notes.xml:984 release_notes.xml:1039 +#, no-c-format +msgid "Enhancements" +msgstr "" + +#. Tag: para +#: release_notes.xml:62 +#, no-c-format +msgid "#3223, Add memcmp short-circuit to ST_Equals (Daniel Baston)" +msgstr "" + +#. Tag: para +#: release_notes.xml:63 +#, no-c-format +msgid "#3227, Tiger geocoder upgraded to support Tiger 2015 census" +msgstr "" + +#. Tag: para +#: release_notes.xml:64 +#, no-c-format +msgid "#2278, Make liblwgeom compatible between minor releases" +msgstr "" + +#. Tag: para +#: release_notes.xml:65 +#, no-c-format +msgid "#897, ST_AsX3D support for GeoCoordinates and systems \"GD\" \"WE\" ability to flip x/y axis (use option = 2, 3)" +msgstr "" + +#. Tag: para +#: release_notes.xml:66 +#, no-c-format +msgid "ST_Split: allow splitting lines by multilines, multipoints and (multi)polygon boundaries" +msgstr "" + +#. Tag: para +#: release_notes.xml:67 +#, no-c-format +msgid "#3070, Simplify geometry type constraint" +msgstr "" + +#. Tag: para +#: release_notes.xml:68 +#, no-c-format +msgid "#2839, Implement selectivity estimator for functional indexes, speeding up spatial queries on raster tables. (Sandro Santilli / Vizzuality)" +msgstr "" + +#. Tag: para +#: release_notes.xml:69 +#, no-c-format +msgid "#2361, Added spatial_index column to raster_columns view" +msgstr "" + +#. Tag: para +#: release_notes.xml:70 +#, no-c-format +msgid "#2390, Testsuite for pgsql2shp" +msgstr "" + +#. Tag: para +#: release_notes.xml:71 +#, no-c-format +msgid "#2527, Added -k flag to raster2pgsql to skip checking that band is NODATA" +msgstr "" + +#. Tag: para +#: release_notes.xml:72 +#, no-c-format +msgid "#2616, Reduce text casts during topology building and export" +msgstr "" + +#. Tag: para +#: release_notes.xml:73 +#, no-c-format +msgid "#2717, support startpoint, endpoint, pointn, numpoints for compoundcurve" +msgstr "" + +#. Tag: para +#: release_notes.xml:74 +#, no-c-format +msgid "#2747, Add support for GDAL 2.0" +msgstr "" + +#. Tag: para +#: release_notes.xml:75 +#, no-c-format +msgid "#2754, SFCGAL can now be installed with CREATE EXTENSION (Vincent Mora @ Oslandia)" +msgstr "" + +#. Tag: para +#: release_notes.xml:76 +#, no-c-format +msgid "#2828, Convert ST_Envelope(raster) from SQL to C" +msgstr "" + +#. Tag: para +#: release_notes.xml:77 release_notes.xml:115 +#, no-c-format +msgid "#2829, Shortcut ST_Clip(raster) if geometry fully contains the raster and no NODATA specified" +msgstr "" + +#. Tag: para +#: release_notes.xml:78 +#, no-c-format +msgid "#2906, Update tiger geocoder to handle tiger 2014 data" +msgstr "" + +#. Tag: para +#: release_notes.xml:79 +#, no-c-format +msgid "#3048, Speed up geometry simplification (J.Santana @ CartoDB)" +msgstr "" + +#. Tag: para +#: release_notes.xml:80 +#, no-c-format +msgid "#3092, Slow performance of geometry_columns with many tables" +msgstr "" + +#. Tag: title +#: release_notes.xml:85 +#, no-c-format +msgid "Release 2.1.5" +msgstr "" + +#. Tag: para +#: release_notes.xml:86 +#, no-c-format +msgid "Release date: 2014-12-18" +msgstr "" + +#. Tag: para +#: release_notes.xml:87 release_notes.xml:108 +#, no-c-format +msgid "This is a bug fix and performance improvement release." +msgstr "" + +#. Tag: para +#: release_notes.xml:90 +#, no-c-format +msgid "#2933, Speedup construction of large multi-geometry objects" msgstr "" #. Tag: title -#: release_notes.xml:59 +#: release_notes.xml:93 release_notes.xml:121 release_notes.xml:182 release_notes.xml:193 release_notes.xml:234 release_notes.xml:490 release_notes.xml:516 release_notes.xml:558 release_notes.xml:582 release_notes.xml:645 release_notes.xml:800 release_notes.xml:814 release_notes.xml:852 release_notes.xml:890 release_notes.xml:921 +#, no-c-format +msgid "Bug Fixes" +msgstr "" + +#. Tag: para +#: release_notes.xml:95 +#, no-c-format +msgid "#2947, Fix memory leak in lwgeom_make_valid for single-component collection input" +msgstr "" + +#. Tag: para +#: release_notes.xml:97 +#, no-c-format +msgid "#2949, Fix memory leak in lwgeom_mindistance2d for curve input" +msgstr "" + +#. Tag: para +#: release_notes.xml:98 +#, no-c-format +msgid "#2931, BOX representation is case sensitive" +msgstr "" + +#. Tag: para +#: release_notes.xml:99 +#, no-c-format +msgid "#2942, PostgreSQL 9.5 support" +msgstr "" + +#. Tag: para +#: release_notes.xml:100 +#, no-c-format +msgid "#2953, 2D stats not generated when Z/M values are extreme" +msgstr "" + +#. Tag: para +#: release_notes.xml:101 +#, no-c-format +msgid "#3009, Geography cast may effect underlying tuple" +msgstr "" + +#. Tag: title +#: release_notes.xml:106 +#, no-c-format +msgid "Release 2.1.4" +msgstr "" + +#. Tag: para +#: release_notes.xml:107 +#, no-c-format +msgid "Release date: 2014-09-10" +msgstr "" + +#. Tag: para +#: release_notes.xml:111 +#, no-c-format +msgid "#2745, Speedup ST_Simplify calls against points" +msgstr "" + +#. Tag: para +#: release_notes.xml:112 +#, no-c-format +msgid "#2747, Support for GDAL 2.0" +msgstr "" + +#. Tag: para +#: release_notes.xml:113 +#, no-c-format +msgid "#2749, Make rtpostgis_upgrade_20_21.sql ACID" +msgstr "" + +#. Tag: para +#: release_notes.xml:114 +#, no-c-format +msgid "#2811, Do not specify index names when loading shapefiles/rasters" +msgstr "" + +#. Tag: para +#: release_notes.xml:117 +#, no-c-format +msgid "#2895, Raise cost of ST_ConvexHull(raster) to 300 for better query plans" +msgstr "" + +#. Tag: para +#: release_notes.xml:122 +#, no-c-format +msgid "#2605, armel: _ST_Covers() returns true for point in hole" +msgstr "" + +#. Tag: para +#: release_notes.xml:123 +#, no-c-format +msgid "#2911, Fix output scale on ST_Rescale/ST_Resample/ST_Resize of rasters with scale 1/-1 and offset 0/0." +msgstr "" + +#. Tag: para +#: release_notes.xml:125 +#, no-c-format +msgid "Fix crash in ST_Union(raster)" +msgstr "" + +#. Tag: para +#: release_notes.xml:126 +#, no-c-format +msgid "#2704, ST_GeomFromGML() does not work properly with array of gml:pos (Even Roualt)" +msgstr "" + +#. Tag: para +#: release_notes.xml:128 +#, no-c-format +msgid "#2708, updategeometrysrid doesn't update srid check when schema not specified. Patch from Marc Jansen" +msgstr "" + +#. Tag: para +#: release_notes.xml:130 +#, no-c-format +msgid "#2720, lwpoly_add_ring should update maxrings after realloc" +msgstr "" + +#. Tag: para +#: release_notes.xml:131 +#, no-c-format +msgid "#2759, Fix postgis_restore.pl handling of multiline object comments embedding sql comments" +msgstr "" + +#. Tag: para +#: release_notes.xml:133 +#, no-c-format +msgid "#2774, fix undefined behavior in ptarray_calculate_gbox_geodetic" +msgstr "" + +#. Tag: para +#: release_notes.xml:134 +#, no-c-format +msgid "Fix potential memory fault in ST_MakeValid" +msgstr "" + +#. Tag: para +#: release_notes.xml:135 +#, no-c-format +msgid "#2784, Fix handling of bogus argument to --with-sfcgal" +msgstr "" + +#. Tag: para +#: release_notes.xml:136 +#, no-c-format +msgid "#2772, Premature memory free in RASTER_getBandPath (ST_BandPath)" +msgstr "" + +#. Tag: para +#: release_notes.xml:137 +#, no-c-format +msgid "#2755, Fix regressions tests against all versions of SFCGAL" +msgstr "" + +#. Tag: para +#: release_notes.xml:138 +#, no-c-format +msgid "#2775, lwline_from_lwmpoint leaks memory" +msgstr "" + +#. Tag: para +#: release_notes.xml:139 +#, no-c-format +msgid "#2802, ST_MapAlgebra checks for valid callback function return value" +msgstr "" + +#. Tag: para +#: release_notes.xml:140 +#, no-c-format +msgid "#2803, ST_MapAlgebra handles no userarg and STRICT callback function" +msgstr "" + +#. Tag: para +#: release_notes.xml:141 +#, no-c-format +msgid "#2834, ST_Estimated_Extent and mixedCase table names (regression bug)" +msgstr "" + +#. Tag: para +#: release_notes.xml:142 +#, no-c-format +msgid "#2845, Bad geometry created from ST_AddPoint" +msgstr "" + +#. Tag: para +#: release_notes.xml:143 +#, no-c-format +msgid "#2870, Binary insert into geography column results geometry being inserted" +msgstr "" + +#. Tag: para +#: release_notes.xml:144 +#, no-c-format +msgid "#2872, make install builds documentation (Greg Troxell)" +msgstr "" + +#. Tag: para +#: release_notes.xml:145 +#, no-c-format +msgid "#2819, find isfinite or replacement on Centos5 / Solaris" +msgstr "" + +#. Tag: para +#: release_notes.xml:146 +#, no-c-format +msgid "#2899, geocode limit 1 not returning best answer (tiger geocoder)" +msgstr "" + +#. Tag: para +#: release_notes.xml:147 +#, no-c-format +msgid "#2903, Unable to compile on FreeBSD" +msgstr "" + +#. Tag: para +#: release_notes.xml:148 +#, no-c-format +msgid "#2927 reverse_geocode not filling in direction prefix (tiger geocoder) get rid of deprecated ST_Line_Locate_Point called" +msgstr "" + +#. Tag: title +#: release_notes.xml:154 #, no-c-format msgid "Release 2.1.3" msgstr "" #. Tag: para -#: release_notes.xml:60 +#: release_notes.xml:155 #, no-c-format msgid "Release date: 2014/05/13" msgstr "" #. Tag: para -#: release_notes.xml:61 +#: release_notes.xml:156 #, no-c-format msgid "This is a bug fix and security release." msgstr "" #. Tag: title -#: release_notes.xml:63 +#: release_notes.xml:158 #, no-c-format msgid "Important changes" msgstr "" #. Tag: para -#: release_notes.xml:64 +#: release_notes.xml:159 #, no-c-format msgid "Starting with this version offline raster access and use of GDAL drivers are disabled by default." msgstr "" #. Tag: para -#: release_notes.xml:69 +#: release_notes.xml:164 #, no-c-format msgid "An environment variable is introduced to allow for enabling specific GDAL drivers: POSTGIS_GDAL_ENABLED_DRIVERS. By default, all GDAL drivers are disabled" msgstr "" #. Tag: para -#: release_notes.xml:75 +#: release_notes.xml:170 #, no-c-format msgid "An environment variable is introduced to allow for enabling out-db raster bands: POSTGIS_ENABLE_OUTDB_RASTERS. By default, out-db raster bands are disabled" msgstr "" #. Tag: para -#: release_notes.xml:81 +#: release_notes.xml:176 #, no-c-format msgid "The environment variables must be set for the PostgreSQL process, and determines the behavior of the whole cluster." msgstr "" #. Tag: para -#: release_notes.xml:88 +#: release_notes.xml:183 #, no-c-format -msgid "#2697, invalid GeoJSON Polygon input crashes server process" +msgid "#2697, invalid GeoJSON Polygon input crashes server process" msgstr "" #. Tag: para -#: release_notes.xml:89 +#: release_notes.xml:184 #, no-c-format -msgid "#2700, Fix dumping of higher-dimension datasets with null rows" +msgid "#2700, Fix dumping of higher-dimension datasets with null rows" msgstr "" #. Tag: para -#: release_notes.xml:90 +#: release_notes.xml:185 #, no-c-format -msgid "#2706, ST_DumpPoints of EMPTY geometries crashes server" +msgid "#2706, ST_DumpPoints of EMPTY geometries crashes server" msgstr "" #. Tag: title -#: release_notes.xml:94 +#: release_notes.xml:189 #, no-c-format msgid "Release 2.1.2" msgstr "" #. Tag: para -#: release_notes.xml:95 release_notes.xml:392 +#: release_notes.xml:190 release_notes.xml:487 #, no-c-format msgid "Release date: 2014/03/31" msgstr "" #. Tag: para -#: release_notes.xml:96 +#: release_notes.xml:191 #, no-c-format msgid "This is a bug fix release, addressing issues that have been filed since the 2.1.1 release." msgstr "" #. Tag: para -#: release_notes.xml:99 +#: release_notes.xml:194 #, no-c-format -msgid "#2666, Error out at configure time if no SQL preprocessor can be found" +msgid "#2666, Error out at configure time if no SQL preprocessor can be found" msgstr "" #. Tag: para -#: release_notes.xml:100 +#: release_notes.xml:195 #, no-c-format -msgid "#2534, st_distance returning incorrect results for large geographies" +msgid "#2534, st_distance returning incorrect results for large geographies" msgstr "" #. Tag: para -#: release_notes.xml:101 +#: release_notes.xml:196 #, no-c-format -msgid "#2539, Check for json-c/json.h presence/usability before json/json.h" +msgid "#2539, Check for json-c/json.h presence/usability before json/json.h" msgstr "" #. Tag: para -#: release_notes.xml:102 +#: release_notes.xml:197 #, no-c-format -msgid "#2543, invalid join selectivity error from simple query" +msgid "#2543, invalid join selectivity error from simple query" msgstr "" #. Tag: para -#: release_notes.xml:103 +#: release_notes.xml:198 #, no-c-format -msgid "#2546, GeoJSON with string coordinates parses incorrectly" +msgid "#2546, GeoJSON with string coordinates parses incorrectly" msgstr "" #. Tag: para -#: release_notes.xml:104 +#: release_notes.xml:199 #, no-c-format -msgid "#2547, Fix ST_Simplify(TopoGeometry) for hierarchical topogeoms" +msgid "#2547, Fix ST_Simplify(TopoGeometry) for hierarchical topogeoms" msgstr "" #. Tag: para -#: release_notes.xml:105 release_notes.xml:402 +#: release_notes.xml:200 release_notes.xml:497 #, no-c-format -msgid "#2552, Fix NULL raster handling in ST_AsPNG, ST_AsTIFF and ST_AsJPEG" +msgid "#2552, Fix NULL raster handling in ST_AsPNG, ST_AsTIFF and ST_AsJPEG" msgstr "" #. Tag: para -#: release_notes.xml:107 release_notes.xml:403 +#: release_notes.xml:202 release_notes.xml:498 #, no-c-format -msgid "#2555, Fix parsing issue of range arguments of ST_Reclass" +msgid "#2555, Fix parsing issue of range arguments of ST_Reclass" msgstr "" #. Tag: para -#: release_notes.xml:108 +#: release_notes.xml:203 #, no-c-format -msgid "#2556, geography ST_Intersects results depending on insert order" +msgid "#2556, geography ST_Intersects results depending on insert order" msgstr "" #. Tag: para -#: release_notes.xml:109 +#: release_notes.xml:204 #, no-c-format -msgid "#2580, Do not allow installing postgis twice in the same database" +msgid "#2580, Do not allow installing postgis twice in the same database" msgstr "" #. Tag: para -#: release_notes.xml:110 release_notes.xml:404 +#: release_notes.xml:205 release_notes.xml:499 #, no-c-format -msgid "#2589, Remove use of unnecessary void pointers" +msgid "#2589, Remove use of unnecessary void pointers" msgstr "" #. Tag: para -#: release_notes.xml:111 +#: release_notes.xml:206 #, no-c-format -msgid "#2607, Cannot open more than 1024 out-db files in one process" +msgid "#2607, Cannot open more than 1024 out-db files in one process" msgstr "" #. Tag: para -#: release_notes.xml:112 release_notes.xml:406 +#: release_notes.xml:207 release_notes.xml:501 #, no-c-format -msgid "#2610, Ensure face splitting algorithm uses the edge index" +msgid "#2610, Ensure face splitting algorithm uses the edge index" msgstr "" #. Tag: para -#: release_notes.xml:113 +#: release_notes.xml:208 #, no-c-format -msgid "#2615, EstimatedExtent (and hence, underlying stats) gathering wrong bbox" +msgid "#2615, EstimatedExtent (and hence, underlying stats) gathering wrong bbox" msgstr "" #. Tag: para -#: release_notes.xml:114 +#: release_notes.xml:209 #, no-c-format -msgid "#2619, Empty rings array in GeoJSON polygon causes crash" +msgid "#2619, Empty rings array in GeoJSON polygon causes crash" msgstr "" #. Tag: para -#: release_notes.xml:115 +#: release_notes.xml:210 #, no-c-format -msgid "#2634, regression in sphere distance code" +msgid "#2634, regression in sphere distance code" msgstr "" #. Tag: para -#: release_notes.xml:116 release_notes.xml:408 +#: release_notes.xml:211 release_notes.xml:503 #, no-c-format -msgid "#2638, Geography distance on M geometries sometimes wrong" +msgid "#2638, Geography distance on M geometries sometimes wrong" msgstr "" #. Tag: para -#: release_notes.xml:117 +#: release_notes.xml:212 #, no-c-format -msgid "#2648, #2653, Fix topology functions when \"topology\" is not in search_path" +msgid "#2648, #2653, Fix topology functions when \"topology\" is not in search_path" msgstr "" #. Tag: para -#: release_notes.xml:118 +#: release_notes.xml:213 #, no-c-format -msgid "#2654, Drop deprecated calls from topology" +msgid "#2654, Drop deprecated calls from topology" msgstr "" #. Tag: para -#: release_notes.xml:119 +#: release_notes.xml:214 #, no-c-format -msgid "#2655, Let users without topology privileges call postgis_full_version()" +msgid "#2655, Let users without topology privileges call postgis_full_version()" msgstr "" #. Tag: para -#: release_notes.xml:120 +#: release_notes.xml:215 #, no-c-format -msgid "#2674, Fix missing operator = and hash_raster_ops opclass on raster" +msgid "#2674, Fix missing operator = and hash_raster_ops opclass on raster" msgstr "" #. Tag: para -#: release_notes.xml:121 +#: release_notes.xml:216 #, no-c-format -msgid "#2675, #2534, #2636, #2634, #2638, Geography distance issues with tree optimization" +msgid "#2675, #2534, #2636, #2634, #2638, Geography distance issues with tree optimization" msgstr "" #. Tag: para -#: release_notes.xml:125 +#: release_notes.xml:220 #, no-c-format -msgid "#2494, avoid memcopy in GiST index (hayamiz)" +msgid "#2494, avoid memcopy in GiST index (hayamiz)" msgstr "" #. Tag: para -#: release_notes.xml:126 +#: release_notes.xml:221 #, no-c-format -msgid "#2560, soft upgrade: avoid drop/recreate of aggregates that hadn't changed" +msgid "#2560, soft upgrade: avoid drop/recreate of aggregates that hadn't changed" msgstr "" #. Tag: title -#: release_notes.xml:131 +#: release_notes.xml:226 #, no-c-format msgid "Release 2.1.1" msgstr "" #. Tag: para -#: release_notes.xml:132 +#: release_notes.xml:227 #, no-c-format msgid "Release date: 2013/11/06" msgstr "" #. Tag: para -#: release_notes.xml:133 +#: release_notes.xml:228 #, no-c-format msgid "This is a bug fix release, addressing issues that have been filed since the 2.1.0 release." msgstr "" #. Tag: title -#: release_notes.xml:135 release_notes.xml:411 +#: release_notes.xml:230 release_notes.xml:506 #, no-c-format msgid "Important Changes" msgstr "" #. Tag: para -#: release_notes.xml:136 +#: release_notes.xml:231 #, no-c-format -msgid "#2514, Change raster license from GPL v3+ to v2+, allowing distribution of PostGIS Extension as GPLv2." +msgid "#2514, Change raster license from GPL v3+ to v2+, allowing distribution of PostGIS Extension as GPLv2." msgstr "" #. Tag: para -#: release_notes.xml:140 +#: release_notes.xml:235 #, no-c-format -msgid "#2396, Make regression tests more endian-agnostic" +msgid "#2396, Make regression tests more endian-agnostic" msgstr "" #. Tag: para -#: release_notes.xml:141 +#: release_notes.xml:236 #, no-c-format -msgid "#2434, Fix ST_Intersection(geog,geog) regression in rare cases" +msgid "#2434, Fix ST_Intersection(geog,geog) regression in rare cases" msgstr "" #. Tag: para -#: release_notes.xml:142 +#: release_notes.xml:237 #, no-c-format -msgid "#2454, Fix behavior of ST_PixelAsXXX functions regarding exclude_nodata_value parameter" +msgid "#2454, Fix behavior of ST_PixelAsXXX functions regarding exclude_nodata_value parameter" msgstr "" #. Tag: para -#: release_notes.xml:143 +#: release_notes.xml:238 #, no-c-format -msgid "#2489, Fix upgrades from 2.0 leaving stale function signatures" +msgid "#2489, Fix upgrades from 2.0 leaving stale function signatures" msgstr "" #. Tag: para -#: release_notes.xml:144 +#: release_notes.xml:239 #, no-c-format -msgid "#2525, Fix handling of SRID in nested collections" +msgid "#2525, Fix handling of SRID in nested collections" msgstr "" #. Tag: para -#: release_notes.xml:145 +#: release_notes.xml:240 #, no-c-format -msgid "#2449, Fix potential infinite loop in index building" +msgid "#2449, Fix potential infinite loop in index building" msgstr "" #. Tag: para -#: release_notes.xml:146 +#: release_notes.xml:241 #, no-c-format -msgid "#2493, Fix behavior of ST_DumpValues when passed an empty raster" +msgid "#2493, Fix behavior of ST_DumpValues when passed an empty raster" msgstr "" #. Tag: para -#: release_notes.xml:147 release_notes.xml:397 +#: release_notes.xml:242 release_notes.xml:492 #, no-c-format -msgid "#2502, Fix postgis_topology_scripts_installed() install schema" +msgid "#2502, Fix postgis_topology_scripts_installed() install schema" msgstr "" #. Tag: para -#: release_notes.xml:148 release_notes.xml:398 +#: release_notes.xml:243 release_notes.xml:493 #, no-c-format -msgid "#2504, Fix segfault on bogus pgsql2shp call" +msgid "#2504, Fix segfault on bogus pgsql2shp call" msgstr "" #. Tag: para -#: release_notes.xml:149 +#: release_notes.xml:244 #, no-c-format -msgid "#2512, Support for foreign tables and materialized views in raster_columns and raster_overviews" +msgid "#2512, Support for foreign tables and materialized views in raster_columns and raster_overviews" msgstr "" #. Tag: para -#: release_notes.xml:153 +#: release_notes.xml:248 #, no-c-format -msgid "#2478, support for tiger 2013" +msgid "#2478, support for tiger 2013" msgstr "" #. Tag: para -#: release_notes.xml:154 +#: release_notes.xml:249 #, no-c-format -msgid "#2463, support for exact length calculations on arc geometries" +msgid "#2463, support for exact length calculations on arc geometries" msgstr "" #. Tag: title -#: release_notes.xml:160 +#: release_notes.xml:255 #, no-c-format msgid "Release 2.1.0" msgstr "" #. Tag: para -#: release_notes.xml:161 +#: release_notes.xml:256 #, no-c-format msgid "Release date: 2013/08/17" msgstr "" #. Tag: para -#: release_notes.xml:162 +#: release_notes.xml:257 #, no-c-format msgid "This is a minor release addressing both bug fixes and performance and functionality enhancements addressing issues since 2.0.3 release. If you are upgrading from 2.0+, only a soft upgrade is required. If you are upgrading from 1.5 or earlier, a hard upgrade is required." msgstr "" #. Tag: title -#: release_notes.xml:165 release_notes.xml:634 +#: release_notes.xml:260 release_notes.xml:729 #, no-c-format msgid "Important / Breaking Changes" msgstr "" #. Tag: para -#: release_notes.xml:166 +#: release_notes.xml:261 #, no-c-format -msgid "#1653, Removed srid parameter from ST_Resample(raster) and variants with reference raster no longer apply reference raster's SRID." +msgid "#1653, Removed srid parameter from ST_Resample(raster) and variants with reference raster no longer apply reference raster's SRID." msgstr "" #. Tag: para -#: release_notes.xml:168 +#: release_notes.xml:263 #, no-c-format -msgid "#1962 ST_Segmentize - As a result of the introduction of geography support, The construct: SELECT ST_Segmentize('LINESTRING(1 2, 3 4)',0.5); will result in ambiguous function error" +msgid "#1962 ST_Segmentize - As a result of the introduction of geography support, The construct: SELECT ST_Segmentize('LINESTRING(1 2, 3 4)',0.5); will result in ambiguous function error" msgstr "" #. Tag: para -#: release_notes.xml:172 +#: release_notes.xml:267 #, no-c-format -msgid "#2026, ST_Union(raster) now unions all bands of all rasters" +msgid "#2026, ST_Union(raster) now unions all bands of all rasters" msgstr "" #. Tag: para -#: release_notes.xml:173 +#: release_notes.xml:268 #, no-c-format -msgid "#2089, liblwgeom: lwgeom_set_handlers replaces lwgeom_init_allocators." +msgid "#2089, liblwgeom: lwgeom_set_handlers replaces lwgeom_init_allocators." msgstr "" #. Tag: para -#: release_notes.xml:174 +#: release_notes.xml:269 #, no-c-format -msgid "#2150, regular_blocking is no longer a constraint. column of same name in raster_columns now checks for existance of spatially_unique and coverage_tile constraints" +msgid "#2150, regular_blocking is no longer a constraint. column of same name in raster_columns now checks for existance of spatially_unique and coverage_tile constraints" msgstr "" #. Tag: para -#: release_notes.xml:177 +#: release_notes.xml:272 #, no-c-format msgid "ST_Intersects(raster, geometry) behaves in the same manner as ST_Intersects(geometry, raster)." msgstr "" #. Tag: para -#: release_notes.xml:179 +#: release_notes.xml:274 #, no-c-format msgid "point variant of ST_SetValue(raster) previously did not check SRID of input geometry and raster." msgstr "" #. Tag: para -#: release_notes.xml:181 +#: release_notes.xml:276 #, no-c-format msgid "ST_Hillshade parameters azimuth and altitude are now in degrees instead of radians." msgstr "" #. Tag: para -#: release_notes.xml:183 +#: release_notes.xml:278 #, no-c-format msgid "ST_Slope and ST_Aspect return pixel values in degrees instead of radians." msgstr "" #. Tag: para -#: release_notes.xml:184 +#: release_notes.xml:279 #, no-c-format -msgid "#2104, ST_World2RasterCoord, ST_World2RasterCoordX and ST_World2RasterCoordY renamed to ST_WorldToRasterCoord, ST_WorldToRasterCoordX and ST_WorldToRasterCoordY. ST_Raster2WorldCoord, ST_Raster2WorldCoordX and ST_Raster2WorldCoordY renamed to ST_RasterToWorldCoord, ST_RasterToWorldCoordX and ST_RasterToWorldCoordY" +msgid "#2104, ST_World2RasterCoord, ST_World2RasterCoordX and ST_World2RasterCoordY renamed to ST_WorldToRasterCoord, ST_WorldToRasterCoordX and ST_WorldToRasterCoordY. ST_Raster2WorldCoord, ST_Raster2WorldCoordX and ST_Raster2WorldCoordY renamed to ST_RasterToWorldCoord, ST_RasterToWorldCoordX and ST_RasterToWorldCoordY" msgstr "" #. Tag: para -#: release_notes.xml:190 +#: release_notes.xml:285 #, no-c-format msgid "ST_Estimated_Extent renamed to ST_EstimatedExtent" msgstr "" #. Tag: para -#: release_notes.xml:191 +#: release_notes.xml:286 #, no-c-format msgid "ST_Line_Interpolate_Point renamed to ST_LineInterpolatePoint" msgstr "" #. Tag: para -#: release_notes.xml:192 +#: release_notes.xml:287 #, no-c-format msgid "ST_Line_Substring renamed to ST_LineSubstring" msgstr "" #. Tag: para -#: release_notes.xml:193 +#: release_notes.xml:288 #, no-c-format msgid "ST_Line_Locate_Point renamed to ST_LineLocatePoint" msgstr "" #. Tag: para -#: release_notes.xml:194 +#: release_notes.xml:289 #, no-c-format msgid "ST_Force_XXX renamed to ST_ForceXXX" msgstr "" #. Tag: para -#: release_notes.xml:195 +#: release_notes.xml:290 #, no-c-format msgid "ST_MapAlgebraFctNgb and 1 and 2 raster variants of ST_MapAlgebraFct. Use ST_MapAlgebra instead" msgstr "" #. Tag: para -#: release_notes.xml:197 +#: release_notes.xml:292 #, no-c-format msgid "1 and 2 raster variants of ST_MapAlgebraExpr. Use expression variants of ST_MapAlgebra instead" msgstr "" -#. Tag: title -#: release_notes.xml:202 release_notes.xml:661 release_notes.xml:861 release_notes.xml:925 release_notes.xml:1222 -#, no-c-format -msgid "New Features" -msgstr "" - #. Tag: para -#: release_notes.xml:203 +#: release_notes.xml:298 #, no-c-format msgid "- Refer to http://postgis.net/docs/manual-2.1/PostGIS_Special_Functions_Index.html#NewFunctions_2_1 for complete list of new functions" msgstr "" #. Tag: para -#: release_notes.xml:205 +#: release_notes.xml:300 #, no-c-format -msgid "#310, ST_DumpPoints converted to a C function (Nathan Wagner) and much faster" +msgid "#310, ST_DumpPoints converted to a C function (Nathan Wagner) and much faster" msgstr "" #. Tag: para -#: release_notes.xml:206 +#: release_notes.xml:301 #, no-c-format -msgid "#739, UpdateRasterSRID()" +msgid "#739, UpdateRasterSRID()" msgstr "" #. Tag: para -#: release_notes.xml:207 +#: release_notes.xml:302 #, no-c-format -msgid "#945, improved join selectivity, N-D selectivity calculations, user accessible selectivity and stats reader functions for testing (Paul Ramsey / OpenGeo)" +msgid "#945, improved join selectivity, N-D selectivity calculations, user accessible selectivity and stats reader functions for testing (Paul Ramsey / OpenGeo)" msgstr "" #. Tag: para -#: release_notes.xml:210 +#: release_notes.xml:305 #, no-c-format msgid "toTopoGeom with TopoGeometry sink (Sandro Santilli / Vizzuality)" msgstr "" #. Tag: para -#: release_notes.xml:211 +#: release_notes.xml:306 #, no-c-format msgid "clearTopoGeom (Sandro Santilli / Vizzuality)" msgstr "" #. Tag: para -#: release_notes.xml:212 +#: release_notes.xml:307 #, no-c-format msgid "ST_Segmentize(geography) (Paul Ramsey / OpenGeo)" msgstr "" #. Tag: para -#: release_notes.xml:213 +#: release_notes.xml:308 #, no-c-format msgid "ST_DelaunayTriangles (Sandro Santilli / Vizzuality)" msgstr "" #. Tag: para -#: release_notes.xml:214 +#: release_notes.xml:309 #, no-c-format msgid "ST_NearestValue, ST_Neighborhood (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:215 +#: release_notes.xml:310 #, no-c-format msgid "ST_PixelAsPoint, ST_PixelAsPoints (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:216 +#: release_notes.xml:311 #, no-c-format msgid "ST_PixelAsCentroid, ST_PixelAsCentroids (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:217 +#: release_notes.xml:312 #, no-c-format msgid "ST_Raster2WorldCoord, ST_World2RasterCoord (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:218 +#: release_notes.xml:313 #, no-c-format msgid "Additional raster/raster spatial relationship functions (ST_Contains, ST_ContainsProperly, ST_Covers, ST_CoveredBy, ST_Disjoint, ST_Overlaps, ST_Touches, ST_Within, ST_DWithin, ST_DFullyWithin) (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:222 +#: release_notes.xml:317 #, no-c-format msgid "Added array variants of ST_SetValues() to set many pixel values of a band in one call (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:224 +#: release_notes.xml:319 #, no-c-format -msgid "#1293, ST_Resize(raster) to resize rasters based upon width/height" +msgid "#1293, ST_Resize(raster) to resize rasters based upon width/height" msgstr "" #. Tag: para -#: release_notes.xml:225 +#: release_notes.xml:320 #, no-c-format -msgid "#1627, package tiger_geocoder as a PostgreSQL extension" +msgid "#1627, package tiger_geocoder as a PostgreSQL extension" msgstr "" #. Tag: para -#: release_notes.xml:226 +#: release_notes.xml:321 #, no-c-format -msgid "#1643, #2076, Upgrade tiger geocoder to support loading tiger 2011 and 2012 (Regina Obe / Paragon Corporation) Funded by Hunter Systems Group" +msgid "#1643, #2076, Upgrade tiger geocoder to support loading tiger 2011 and 2012 (Regina Obe / Paragon Corporation) Funded by Hunter Systems Group" msgstr "" #. Tag: para -#: release_notes.xml:228 +#: release_notes.xml:323 #, no-c-format msgid "GEOMETRYCOLLECTION support for ST_MakeValid (Sandro Santilli / Vizzuality)" msgstr "" #. Tag: para -#: release_notes.xml:229 +#: release_notes.xml:324 #, no-c-format -msgid "#1709, ST_NotSameAlignmentReason(raster, raster)" +msgid "#1709, ST_NotSameAlignmentReason(raster, raster)" msgstr "" #. Tag: para -#: release_notes.xml:230 +#: release_notes.xml:325 #, no-c-format -msgid "#1818, ST_GeomFromGeoHash and friends (Jason Smith (darkpanda))" +msgid "#1818, ST_GeomFromGeoHash and friends (Jason Smith (darkpanda))" msgstr "" #. Tag: para -#: release_notes.xml:231 +#: release_notes.xml:326 #, no-c-format -msgid "#1856, reverse geocoder rating setting for prefer numbered highway name" +msgid "#1856, reverse geocoder rating setting for prefer numbered highway name" msgstr "" #. Tag: para -#: release_notes.xml:232 +#: release_notes.xml:327 #, no-c-format msgid "ST_PixelOfValue (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:233 +#: release_notes.xml:328 #, no-c-format msgid "Casts to/from PostgreSQL geotypes (point/path/polygon)." msgstr "" #. Tag: para -#: release_notes.xml:234 +#: release_notes.xml:329 #, no-c-format msgid "Added geomval array variant of ST_SetValues() to set many pixel values of a band using a set of geometries and corresponding values in one call (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:237 +#: release_notes.xml:332 #, no-c-format msgid "ST_Tile(raster) to break up a raster into tiles (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:238 +#: release_notes.xml:333 #, no-c-format -msgid "#1895, new r-tree node splitting algorithm (Alex Korotkov)" +msgid "#1895, new r-tree node splitting algorithm (Alex Korotkov)" msgstr "" #. Tag: para -#: release_notes.xml:239 +#: release_notes.xml:334 #, no-c-format -msgid "#2011, ST_DumpValues to output raster as array (Bborie Park / UC Davis)" +msgid "#2011, ST_DumpValues to output raster as array (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:240 +#: release_notes.xml:335 #, no-c-format -msgid "#2018, ST_Distance support for CircularString, CurvePolygon, MultiCurve, MultiSurface, CompoundCurve" +msgid "#2018, ST_Distance support for CircularString, CurvePolygon, MultiCurve, MultiSurface, CompoundCurve" msgstr "" #. Tag: para -#: release_notes.xml:242 +#: release_notes.xml:337 #, no-c-format -msgid "#2030, n-raster (and n-band) ST_MapAlgebra (Bborie Park / UC Davis)" +msgid "#2030, n-raster (and n-band) ST_MapAlgebra (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:243 +#: release_notes.xml:338 #, no-c-format -msgid "#2193, Utilize PAGC parser as drop in replacement for tiger normalizer (Steve Woodbridge, Regina Obe)" +msgid "#2193, Utilize PAGC parser as drop in replacement for tiger normalizer (Steve Woodbridge, Regina Obe)" msgstr "" #. Tag: para -#: release_notes.xml:245 +#: release_notes.xml:340 #, no-c-format -msgid "#2210, ST_MinConvexHull(raster)" +msgid "#2210, ST_MinConvexHull(raster)" msgstr "" #. Tag: para -#: release_notes.xml:246 +#: release_notes.xml:341 #, no-c-format msgid "lwgeom_from_geojson in liblwgeom (Sandro Santilli / Vizzuality)" msgstr "" #. Tag: para -#: release_notes.xml:247 +#: release_notes.xml:342 #, no-c-format -msgid "#1687, ST_Simplify for TopoGeometry (Sandro Santilli / Vizzuality)" +msgid "#1687, ST_Simplify for TopoGeometry (Sandro Santilli / Vizzuality)" msgstr "" #. Tag: para -#: release_notes.xml:248 +#: release_notes.xml:343 #, no-c-format -msgid "#2228, TopoJSON output for TopoGeometry (Sandro Santilli / Vizzuality)" +msgid "#2228, TopoJSON output for TopoGeometry (Sandro Santilli / Vizzuality)" msgstr "" #. Tag: para -#: release_notes.xml:249 +#: release_notes.xml:344 #, no-c-format -msgid "#2123, ST_FromGDALRaster" +msgid "#2123, ST_FromGDALRaster" msgstr "" #. Tag: para -#: release_notes.xml:250 +#: release_notes.xml:345 #, no-c-format -msgid "#613, ST_SetGeoReference with numerical parameters instead of text" +msgid "#613, ST_SetGeoReference with numerical parameters instead of text" msgstr "" #. Tag: para -#: release_notes.xml:251 +#: release_notes.xml:346 #, no-c-format -msgid "#2276, ST_AddBand(raster) variant for out-db bands" +msgid "#2276, ST_AddBand(raster) variant for out-db bands" msgstr "" #. Tag: para -#: release_notes.xml:252 +#: release_notes.xml:347 #, no-c-format -msgid "#2280, ST_Summary(raster)" +msgid "#2280, ST_Summary(raster)" msgstr "" #. Tag: para -#: release_notes.xml:253 +#: release_notes.xml:348 #, no-c-format -msgid "#2163, ST_TPI for raster (Nathaniel Clay)" +msgid "#2163, ST_TPI for raster (Nathaniel Clay)" msgstr "" #. Tag: para -#: release_notes.xml:254 +#: release_notes.xml:349 #, no-c-format -msgid "#2164, ST_TRI for raster (Nathaniel Clay)" +msgid "#2164, ST_TRI for raster (Nathaniel Clay)" msgstr "" #. Tag: para -#: release_notes.xml:255 +#: release_notes.xml:350 #, no-c-format -msgid "#2302, ST_Roughness for raster (Nathaniel Clay)" +msgid "#2302, ST_Roughness for raster (Nathaniel Clay)" msgstr "" #. Tag: para -#: release_notes.xml:256 +#: release_notes.xml:351 #, no-c-format -msgid "#2290, ST_ColorMap(raster) to generate RGBA bands" +msgid "#2290, ST_ColorMap(raster) to generate RGBA bands" msgstr "" #. Tag: para -#: release_notes.xml:257 +#: release_notes.xml:352 #, no-c-format -msgid "#2254, Add SFCGAL backend support. (Backend selection throught postgis.backend var) Functions available both throught GEOS or SFCGAL: ST_Intersects, ST_3DIntersects, ST_Intersection, ST_Area, ST_Distance, ST_3DDistance New functions available only with SFCGAL backend: ST_3DIntersection, ST_Tesselate, ST_3DArea, ST_Extrude, ST_ForceLHR ST_Orientation, ST_Minkowski, ST_StraightSkeleton postgis_sfcgal_version New function available in PostGIS: ST_ForceSFS (Olivier Courtin and Hugo Mercier / Oslandia)" +msgid "#2254, Add SFCGAL backend support. (Backend selection throught postgis.backend var) Functions available both throught GEOS or SFCGAL: ST_Intersects, ST_3DIntersects, ST_Intersection, ST_Area, ST_Distance, ST_3DDistance New functions available only with SFCGAL backend: ST_3DIntersection, ST_Tesselate, ST_3DArea, ST_Extrude, ST_ForceLHR ST_Orientation, ST_Minkowski, ST_StraightSkeleton postgis_sfcgal_version New function available in PostGIS: ST_ForceSFS (Olivier Courtin and Hugo Mercier / Oslandia)" msgstr "" #. Tag: para -#: release_notes.xml:272 +#: release_notes.xml:367 #, no-c-format msgid "For detail of new functions and function improvements, please refer to ." msgstr "" #. Tag: para -#: release_notes.xml:273 +#: release_notes.xml:368 #, no-c-format msgid "Much faster raster ST_Union, ST_Clip and many more function additions operations" msgstr "" #. Tag: para -#: release_notes.xml:274 +#: release_notes.xml:369 #, no-c-format msgid "For geometry/geography better planner selectivity and a lot more functions." msgstr "" #. Tag: para -#: release_notes.xml:276 +#: release_notes.xml:371 #, no-c-format -msgid "#823, tiger geocoder: Make loader_generate_script download portion less greedy" +msgid "#823, tiger geocoder: Make loader_generate_script download portion less greedy" msgstr "" #. Tag: para -#: release_notes.xml:278 +#: release_notes.xml:373 #, no-c-format -msgid "#826, raster2pgsql no longer defaults to padding tiles. Flag -P can be used to pad tiles" +msgid "#826, raster2pgsql no longer defaults to padding tiles. Flag -P can be used to pad tiles" msgstr "" #. Tag: para -#: release_notes.xml:280 +#: release_notes.xml:375 #, no-c-format -msgid "#1363, ST_AddBand(raster, ...) array version rewritten in C" +msgid "#1363, ST_AddBand(raster, ...) array version rewritten in C" msgstr "" #. Tag: para -#: release_notes.xml:281 +#: release_notes.xml:376 #, no-c-format -msgid "#1364, ST_Union(raster, ...) aggregate function rewritten in C" +msgid "#1364, ST_Union(raster, ...) aggregate function rewritten in C" msgstr "" #. Tag: para -#: release_notes.xml:282 +#: release_notes.xml:377 #, no-c-format -msgid "#1655, Additional default values for parameters of ST_Slope" +msgid "#1655, Additional default values for parameters of ST_Slope" msgstr "" #. Tag: para -#: release_notes.xml:283 +#: release_notes.xml:378 #, no-c-format -msgid "#1661, Add aggregate variant of ST_SameAlignment" +msgid "#1661, Add aggregate variant of ST_SameAlignment" msgstr "" #. Tag: para -#: release_notes.xml:284 +#: release_notes.xml:379 #, no-c-format -msgid "#1719, Add support for Point and GeometryCollection ST_MakeValid inputs" +msgid "#1719, Add support for Point and GeometryCollection ST_MakeValid inputs" msgstr "" #. Tag: para -#: release_notes.xml:285 +#: release_notes.xml:380 #, no-c-format -msgid "#1780, support ST_GeoHash for geography" +msgid "#1780, support ST_GeoHash for geography" msgstr "" #. Tag: para -#: release_notes.xml:286 +#: release_notes.xml:381 #, no-c-format -msgid "#1796, Big performance boost for distance calculations in geography" +msgid "#1796, Big performance boost for distance calculations in geography" msgstr "" #. Tag: para -#: release_notes.xml:287 +#: release_notes.xml:382 #, no-c-format -msgid "#1802, improved function interruptibility." +msgid "#1802, improved function interruptibility." msgstr "" #. Tag: para -#: release_notes.xml:288 +#: release_notes.xml:383 #, no-c-format -msgid "#1823, add parameter in ST_AsGML to use id column for GML 3 output (become mandatory since GML 3.2.1)" +msgid "#1823, add parameter in ST_AsGML to use id column for GML 3 output (become mandatory since GML 3.2.1)" msgstr "" #. Tag: para -#: release_notes.xml:290 +#: release_notes.xml:385 #, no-c-format -msgid "#1856, tiger geocoder: reverse geocoder rating setting for prefer numbered highway name" +msgid "#1856, tiger geocoder: reverse geocoder rating setting for prefer numbered highway name" msgstr "" #. Tag: para -#: release_notes.xml:292 +#: release_notes.xml:387 #, no-c-format -msgid "#1938, Refactor basic ST_AddBand to add multiple new bands in one call" +msgid "#1938, Refactor basic ST_AddBand to add multiple new bands in one call" msgstr "" #. Tag: para -#: release_notes.xml:293 +#: release_notes.xml:388 #, no-c-format -msgid "#1978, wrong answer when calculating length of a closed circular arc (circle)" +msgid "#1978, wrong answer when calculating length of a closed circular arc (circle)" msgstr "" #. Tag: para -#: release_notes.xml:295 release_notes.xml:505 +#: release_notes.xml:390 release_notes.xml:600 #, no-c-format -msgid "#1989, Preprocess input geometry to just intersection with raster to be clipped" +msgid "#1989, Preprocess input geometry to just intersection with raster to be clipped" msgstr "" #. Tag: para -#: release_notes.xml:297 +#: release_notes.xml:392 #, no-c-format -msgid "#2021, Added multi-band support to ST_Union(raster, ...) aggregate function" +msgid "#2021, Added multi-band support to ST_Union(raster, ...) aggregate function" msgstr "" #. Tag: para -#: release_notes.xml:298 +#: release_notes.xml:393 #, no-c-format -msgid "#2006, better support of ST_Area(geography) over poles and dateline" +msgid "#2006, better support of ST_Area(geography) over poles and dateline" msgstr "" #. Tag: para -#: release_notes.xml:299 +#: release_notes.xml:394 #, no-c-format -msgid "#2065, ST_Clip(raster, ...) now a C function" +msgid "#2065, ST_Clip(raster, ...) now a C function" msgstr "" #. Tag: para -#: release_notes.xml:300 +#: release_notes.xml:395 #, no-c-format -msgid "#2069, Added parameters to ST_Tile(raster) to control padding of tiles" +msgid "#2069, Added parameters to ST_Tile(raster) to control padding of tiles" msgstr "" #. Tag: para -#: release_notes.xml:301 +#: release_notes.xml:396 #, no-c-format -msgid "#2078, New variants of ST_Slope, ST_Aspect and ST_HillShade to provide solution to handling tiles in a coverage" +msgid "#2078, New variants of ST_Slope, ST_Aspect and ST_HillShade to provide solution to handling tiles in a coverage" msgstr "" #. Tag: para -#: release_notes.xml:303 +#: release_notes.xml:398 #, no-c-format -msgid "#2097, Added RANGE uniontype option for ST_Union(raster)" +msgid "#2097, Added RANGE uniontype option for ST_Union(raster)" msgstr "" #. Tag: para -#: release_notes.xml:304 +#: release_notes.xml:399 #, no-c-format -msgid "#2105, Added ST_Transform(raster) variant for aligning output to reference raster" +msgid "#2105, Added ST_Transform(raster) variant for aligning output to reference raster" msgstr "" #. Tag: para -#: release_notes.xml:306 +#: release_notes.xml:401 #, no-c-format -msgid "#2119, Rasters passed to ST_Resample(), ST_Rescale(), ST_Reskew(), and ST_SnapToGrid() no longer require an SRID" +msgid "#2119, Rasters passed to ST_Resample(), ST_Rescale(), ST_Reskew(), and ST_SnapToGrid() no longer require an SRID" msgstr "" #. Tag: para -#: release_notes.xml:308 release_notes.xml:478 +#: release_notes.xml:403 release_notes.xml:573 #, no-c-format -msgid "#2141, More verbose output when constraints fail to be added to a raster column" +msgid "#2141, More verbose output when constraints fail to be added to a raster column" msgstr "" #. Tag: para -#: release_notes.xml:310 +#: release_notes.xml:405 #, no-c-format -msgid "#2143, Changed blocksize constraint of raster to allow multiple values" +msgid "#2143, Changed blocksize constraint of raster to allow multiple values" msgstr "" #. Tag: para -#: release_notes.xml:311 +#: release_notes.xml:406 #, no-c-format -msgid "#2148, Addition of coverage_tile constraint for raster" +msgid "#2148, Addition of coverage_tile constraint for raster" msgstr "" #. Tag: para -#: release_notes.xml:312 +#: release_notes.xml:407 #, no-c-format -msgid "#2149, Addition of spatially_unique constraint for raster" +msgid "#2149, Addition of spatially_unique constraint for raster" msgstr "" #. Tag: para -#: release_notes.xml:313 +#: release_notes.xml:408 #, no-c-format msgid "TopologySummary output now includes unregistered layers and a count of missing TopoGeometry objects from their natural layer." msgstr "" #. Tag: para -#: release_notes.xml:315 +#: release_notes.xml:410 #, no-c-format msgid "ST_HillShade(), ST_Aspect() and ST_Slope() have one new optional parameter to interpolate NODATA pixels before running the operation." msgstr "" #. Tag: para -#: release_notes.xml:318 +#: release_notes.xml:413 #, no-c-format msgid "Point variant of ST_SetValue(raster) is now a wrapper around geomval variant of ST_SetValues(rast)." msgstr "" #. Tag: para -#: release_notes.xml:320 +#: release_notes.xml:415 #, no-c-format msgid "Proper support for raster band's isnodata flag in core API and loader." msgstr "" #. Tag: para -#: release_notes.xml:321 +#: release_notes.xml:416 #, no-c-format msgid "Additional default values for parameters of ST_Aspect and ST_HillShade" msgstr "" #. Tag: para -#: release_notes.xml:322 +#: release_notes.xml:417 #, no-c-format -msgid "#2178, ST_Summary now advertises presence of known srid with an [S] flag" +msgid "#2178, ST_Summary now advertises presence of known srid with an [S] flag" msgstr "" #. Tag: para -#: release_notes.xml:323 +#: release_notes.xml:418 #, no-c-format -msgid "#2202, Make libjson-c optional (--without-json configure switch)" +msgid "#2202, Make libjson-c optional (--without-json configure switch)" msgstr "" #. Tag: para -#: release_notes.xml:324 +#: release_notes.xml:419 #, no-c-format -msgid "#2213, Add support libjson-c 0.10+" +msgid "#2213, Add support libjson-c 0.10+" msgstr "" #. Tag: para -#: release_notes.xml:325 +#: release_notes.xml:420 #, no-c-format -msgid "#2231, raster2pgsql supports user naming of filename column with -n" +msgid "#2231, raster2pgsql supports user naming of filename column with -n" msgstr "" #. Tag: para -#: release_notes.xml:326 +#: release_notes.xml:421 #, no-c-format -msgid "#2200, ST_Union(raster, uniontype) unions all bands of all rasters" +msgid "#2200, ST_Union(raster, uniontype) unions all bands of all rasters" msgstr "" #. Tag: para -#: release_notes.xml:327 +#: release_notes.xml:422 #, no-c-format -msgid "#2264, postgis_restore.pl support for restoring into databases with postgis in a custom schema" +msgid "#2264, postgis_restore.pl support for restoring into databases with postgis in a custom schema" msgstr "" #. Tag: para -#: release_notes.xml:329 +#: release_notes.xml:424 #, no-c-format -msgid "#2244, emit warning when changing raster's georeference if raster has out-db bands" +msgid "#2244, emit warning when changing raster's georeference if raster has out-db bands" msgstr "" #. Tag: para -#: release_notes.xml:331 +#: release_notes.xml:426 #, no-c-format -msgid "#2222, add parameter OutAsIn to flag whether ST_AsBinary should return out-db bands as in-db bands" +msgid "#2222, add parameter OutAsIn to flag whether ST_AsBinary should return out-db bands as in-db bands" msgstr "" #. Tag: title -#: release_notes.xml:335 +#: release_notes.xml:430 #, no-c-format msgid "Fixes" msgstr "" #. Tag: para -#: release_notes.xml:336 release_notes.xml:580 +#: release_notes.xml:431 release_notes.xml:675 #, no-c-format -msgid "#1839, handling of subdatasets in GeoTIFF in raster2pgsql." +msgid "#1839, handling of subdatasets in GeoTIFF in raster2pgsql." msgstr "" #. Tag: para -#: release_notes.xml:337 release_notes.xml:581 +#: release_notes.xml:432 release_notes.xml:676 #, no-c-format -msgid "#1840, fix logic of when to compute # of tiles in raster2pgsql." +msgid "#1840, fix logic of when to compute # of tiles in raster2pgsql." msgstr "" #. Tag: para -#: release_notes.xml:338 +#: release_notes.xml:433 #, no-c-format -msgid "#1870, align the docs and actual behavior of raster's ST_Intersects" +msgid "#1870, align the docs and actual behavior of raster's ST_Intersects" msgstr "" #. Tag: para -#: release_notes.xml:339 release_notes.xml:587 +#: release_notes.xml:434 release_notes.xml:682 #, no-c-format -msgid "#1872, fix ST_ApproxSummarystats to prevent division by zero" +msgid "#1872, fix ST_ApproxSummarystats to prevent division by zero" msgstr "" #. Tag: para -#: release_notes.xml:340 release_notes.xml:590 +#: release_notes.xml:435 release_notes.xml:685 #, no-c-format -msgid "#1875, ST_SummaryStats returns NULL for all parameters except count when count is zero" +msgid "#1875, ST_SummaryStats returns NULL for all parameters except count when count is zero" msgstr "" #. Tag: para -#: release_notes.xml:342 +#: release_notes.xml:437 #, no-c-format -msgid "#1932, fix raster2pgsql of syntax for index tablespaces" +msgid "#1932, fix raster2pgsql of syntax for index tablespaces" msgstr "" #. Tag: para -#: release_notes.xml:343 release_notes.xml:498 +#: release_notes.xml:438 release_notes.xml:593 #, no-c-format -msgid "#1936, ST_GeomFromGML on CurvePolygon causes server crash" +msgid "#1936, ST_GeomFromGML on CurvePolygon causes server crash" msgstr "" #. Tag: para -#: release_notes.xml:344 +#: release_notes.xml:439 #, no-c-format -msgid "#1939, remove custom data types: summarystats, histogram, quantile, valuecount" +msgid "#1939, remove custom data types: summarystats, histogram, quantile, valuecount" msgstr "" #. Tag: para -#: release_notes.xml:346 +#: release_notes.xml:441 #, no-c-format -msgid "#1951, remove crash on zero-length linestrings" +msgid "#1951, remove crash on zero-length linestrings" msgstr "" #. Tag: para -#: release_notes.xml:347 release_notes.xml:500 +#: release_notes.xml:442 release_notes.xml:595 #, no-c-format -msgid "#1957, ST_Distance to a one-point LineString returns NULL" +msgid "#1957, ST_Distance to a one-point LineString returns NULL" msgstr "" #. Tag: para -#: release_notes.xml:348 release_notes.xml:501 +#: release_notes.xml:443 release_notes.xml:596 #, no-c-format -msgid "#1976, Geography point-in-ring code overhauled for more reliability" +msgid "#1976, Geography point-in-ring code overhauled for more reliability" msgstr "" #. Tag: para -#: release_notes.xml:349 +#: release_notes.xml:444 #, no-c-format -msgid "#1981, cleanup of unused variables causing warnings with gcc 4.6+" +msgid "#1981, cleanup of unused variables causing warnings with gcc 4.6+" msgstr "" #. Tag: para -#: release_notes.xml:350 release_notes.xml:508 +#: release_notes.xml:445 release_notes.xml:603 #, no-c-format -msgid "#1996, support POINT EMPTY in GeoJSON output" +msgid "#1996, support POINT EMPTY in GeoJSON output" msgstr "" #. Tag: para -#: release_notes.xml:351 +#: release_notes.xml:446 #, no-c-format -msgid "#2062, improve performance of distance calculations" +msgid "#2062, improve performance of distance calculations" msgstr "" #. Tag: para -#: release_notes.xml:352 release_notes.xml:519 +#: release_notes.xml:447 release_notes.xml:614 #, no-c-format -msgid "#2057, Fixed linking issue for raster2psql to libpq" +msgid "#2057, Fixed linking issue for raster2psql to libpq" msgstr "" #. Tag: para -#: release_notes.xml:353 +#: release_notes.xml:448 #, no-c-format -msgid "#2077, Fixed incorrect values returning from ST_Hillshade()" +msgid "#2077, Fixed incorrect values returning from ST_Hillshade()" msgstr "" #. Tag: para -#: release_notes.xml:354 release_notes.xml:512 +#: release_notes.xml:449 release_notes.xml:607 #, no-c-format -msgid "#2019, ST_FlipCoordinates does not update bbox" +msgid "#2019, ST_FlipCoordinates does not update bbox" msgstr "" #. Tag: para -#: release_notes.xml:355 +#: release_notes.xml:450 #, no-c-format -msgid "#2100, ST_AsRaster may not return raster with specified pixel type" +msgid "#2100, ST_AsRaster may not return raster with specified pixel type" msgstr "" #. Tag: para -#: release_notes.xml:356 release_notes.xml:464 +#: release_notes.xml:451 release_notes.xml:559 #, no-c-format -msgid "#2126, Better handling of empty rasters from ST_ConvexHull()" +msgid "#2126, Better handling of empty rasters from ST_ConvexHull()" msgstr "" #. Tag: para -#: release_notes.xml:357 release_notes.xml:425 +#: release_notes.xml:452 release_notes.xml:520 #, no-c-format -msgid "#2165, ST_NumPoints regression failure with CircularString" +msgid "#2165, ST_NumPoints regression failure with CircularString" msgstr "" #. Tag: para -#: release_notes.xml:358 release_notes.xml:426 +#: release_notes.xml:453 release_notes.xml:521 #, no-c-format -msgid "#2168, ST_Distance is not always commutative" +msgid "#2168, ST_Distance is not always commutative" msgstr "" #. Tag: para -#: release_notes.xml:359 +#: release_notes.xml:454 #, no-c-format -msgid "#2182, Fix issue with outdb rasters with no SRID and ST_Resize" +msgid "#2182, Fix issue with outdb rasters with no SRID and ST_Resize" msgstr "" #. Tag: para -#: release_notes.xml:360 release_notes.xml:472 +#: release_notes.xml:455 release_notes.xml:567 #, no-c-format -msgid "#2188, Fix function parameter value overflow that caused problems when copying data from a GDAL dataset" +msgid "#2188, Fix function parameter value overflow that caused problems when copying data from a GDAL dataset" msgstr "" #. Tag: para -#: release_notes.xml:362 +#: release_notes.xml:457 #, no-c-format -msgid "#2198, Fix incorrect dimensions used when generating bands of out-db rasters in ST_Tile()" +msgid "#2198, Fix incorrect dimensions used when generating bands of out-db rasters in ST_Tile()" msgstr "" #. Tag: para -#: release_notes.xml:364 release_notes.xml:428 +#: release_notes.xml:459 release_notes.xml:523 #, no-c-format -msgid "#2201, ST_GeoHash wrong on boundaries" +msgid "#2201, ST_GeoHash wrong on boundaries" msgstr "" #. Tag: para -#: release_notes.xml:365 +#: release_notes.xml:460 #, no-c-format -msgid "#2203, Changed how rasters with unknown SRID and default geotransform are handled when passing to GDAL Warp API" +msgid "#2203, Changed how rasters with unknown SRID and default geotransform are handled when passing to GDAL Warp API" msgstr "" #. Tag: para -#: release_notes.xml:367 +#: release_notes.xml:462 #, no-c-format -msgid "#2215, Fixed raster exclusion constraint for conflicting name of implicit index" +msgid "#2215, Fixed raster exclusion constraint for conflicting name of implicit index" msgstr "" #. Tag: para -#: release_notes.xml:369 +#: release_notes.xml:464 #, no-c-format -msgid "#2251, Fix bad dimensions when rescaling rasters with default geotransform matrix" +msgid "#2251, Fix bad dimensions when rescaling rasters with default geotransform matrix" msgstr "" #. Tag: para -#: release_notes.xml:371 +#: release_notes.xml:466 #, no-c-format -msgid "#2133, Fix performance regression in expression variant of ST_MapAlgebra" +msgid "#2133, Fix performance regression in expression variant of ST_MapAlgebra" msgstr "" #. Tag: para -#: release_notes.xml:372 release_notes.xml:429 +#: release_notes.xml:467 release_notes.xml:524 #, no-c-format -msgid "#2257, GBOX variables not initialized when testing with empty geometries" +msgid "#2257, GBOX variables not initialized when testing with empty geometries" msgstr "" #. Tag: para -#: release_notes.xml:373 release_notes.xml:430 +#: release_notes.xml:468 release_notes.xml:525 #, no-c-format -msgid "#2271, Prevent parallel make of raster" +msgid "#2271, Prevent parallel make of raster" msgstr "" #. Tag: para -#: release_notes.xml:374 +#: release_notes.xml:469 #, no-c-format -msgid "#2282, Fix call to undefined function nd_stats_to_grid() in debug mode" +msgid "#2282, Fix call to undefined function nd_stats_to_grid() in debug mode" msgstr "" #. Tag: para -#: release_notes.xml:375 release_notes.xml:433 +#: release_notes.xml:470 release_notes.xml:528 #, no-c-format -msgid "#2307, ST_MakeValid outputs invalid geometries" +msgid "#2307, ST_MakeValid outputs invalid geometries" msgstr "" #. Tag: para -#: release_notes.xml:376 +#: release_notes.xml:471 #, no-c-format -msgid "#2309, Remove confusing INFO message when trying to get SRS info" +msgid "#2309, Remove confusing INFO message when trying to get SRS info" msgstr "" #. Tag: para -#: release_notes.xml:377 +#: release_notes.xml:472 #, no-c-format -msgid "#2336, FIPS 20 (KS) causes wildcard expansion to wget all files" +msgid "#2336, FIPS 20 (KS) causes wildcard expansion to wget all files" msgstr "" #. Tag: para -#: release_notes.xml:378 +#: release_notes.xml:473 #, no-c-format -msgid "#2348, Provide raster upgrade path for 2.0 to 2.1" +msgid "#2348, Provide raster upgrade path for 2.0 to 2.1" msgstr "" #. Tag: para -#: release_notes.xml:379 release_notes.xml:434 +#: release_notes.xml:474 release_notes.xml:529 #, no-c-format -msgid "#2351, st_distance between geographies wrong" +msgid "#2351, st_distance between geographies wrong" msgstr "" #. Tag: para -#: release_notes.xml:380 +#: release_notes.xml:475 #, no-c-format -msgid "#2359, Fix handling of schema name when adding overview constraints" +msgid "#2359, Fix handling of schema name when adding overview constraints" msgstr "" #. Tag: para -#: release_notes.xml:381 release_notes.xml:436 +#: release_notes.xml:476 release_notes.xml:531 #, no-c-format -msgid "#2371, Support GEOS versions with more than 1 digit in micro" +msgid "#2371, Support GEOS versions with more than 1 digit in micro" msgstr "" #. Tag: para -#: release_notes.xml:382 +#: release_notes.xml:477 #, no-c-format -msgid "#2383, Remove unsafe use of \\' from raster warning message" +msgid "#2383, Remove unsafe use of \\' from raster warning message" msgstr "" #. Tag: para -#: release_notes.xml:383 +#: release_notes.xml:478 #, no-c-format -msgid "#2384, Incorrect variable datatypes for ST_Neighborhood" +msgid "#2384, Incorrect variable datatypes for ST_Neighborhood" msgstr "" #. Tag: title -#: release_notes.xml:385 release_notes.xml:453 +#: release_notes.xml:480 release_notes.xml:548 #, no-c-format msgid "Known Issues" msgstr "" #. Tag: para -#: release_notes.xml:386 release_notes.xml:454 +#: release_notes.xml:481 release_notes.xml:549 #, no-c-format -msgid "#2111, Raster bands can only reference the first 256 bands of out-db rasters" +msgid "#2111, Raster bands can only reference the first 256 bands of out-db rasters" msgstr "" #. Tag: title -#: release_notes.xml:391 +#: release_notes.xml:486 #, no-c-format msgid "Release 2.0.5" msgstr "" #. Tag: para -#: release_notes.xml:393 +#: release_notes.xml:488 #, no-c-format msgid "This is a bug fix release, addressing issues that have been filed since the 2.0.4 release. If you are using PostGIS 2.0+ a soft upgrade is required. For users of PostGIS 1.5 or below, a hard upgrade is required." msgstr "" #. Tag: para -#: release_notes.xml:396 +#: release_notes.xml:491 #, no-c-format -msgid "#2494, avoid memcpy in GIST index" +msgid "#2494, avoid memcpy in GIST index" msgstr "" #. Tag: para -#: release_notes.xml:399 +#: release_notes.xml:494 #, no-c-format -msgid "#2528, Fix memory leak in ST_Split / lwline_split_by_line" +msgid "#2528, Fix memory leak in ST_Split / lwline_split_by_line" msgstr "" #. Tag: para -#: release_notes.xml:400 +#: release_notes.xml:495 #, no-c-format -msgid "#2532, Add missing raster/geometry commutator operators" +msgid "#2532, Add missing raster/geometry commutator operators" msgstr "" #. Tag: para -#: release_notes.xml:401 +#: release_notes.xml:496 #, no-c-format -msgid "#2533, Remove duplicated signatures" +msgid "#2533, Remove duplicated signatures" msgstr "" #. Tag: para -#: release_notes.xml:405 +#: release_notes.xml:500 #, no-c-format -msgid "#2607, Cannot open more than 1024 out-db files in process" +msgid "#2607, Cannot open more than 1024 out-db files in process" msgstr "" #. Tag: para -#: release_notes.xml:407 +#: release_notes.xml:502 #, no-c-format -msgid "#2619, Empty ring array in GeoJSON polygon causes crash" +msgid "#2619, Empty ring array in GeoJSON polygon causes crash" msgstr "" #. Tag: para -#: release_notes.xml:412 +#: release_notes.xml:507 #, no-c-format -msgid "##2514, Change raster license from GPL v3+ to v2+, allowing distribution of PostGIS Extension as GPLv2." +msgid "##2514, Change raster license from GPL v3+ to v2+, allowing distribution of PostGIS Extension as GPLv2." msgstr "" #. Tag: title -#: release_notes.xml:417 +#: release_notes.xml:512 #, no-c-format msgid "Release 2.0.4" msgstr "" #. Tag: para -#: release_notes.xml:418 +#: release_notes.xml:513 #, no-c-format msgid "Release date: 2013/09/06" msgstr "" #. Tag: para -#: release_notes.xml:419 +#: release_notes.xml:514 #, no-c-format msgid "This is a bug fix release, addressing issues that have been filed since the 2.0.3 release. If you are using PostGIS 2.0+ a soft upgrade is required. For users of PostGIS 1.5 or below, a hard upgrade is required." msgstr "" #. Tag: para -#: release_notes.xml:422 +#: release_notes.xml:517 #, no-c-format -msgid "#2110, Equality operator between EMPTY and point on origin" +msgid "#2110, Equality operator between EMPTY and point on origin" msgstr "" #. Tag: para -#: release_notes.xml:423 +#: release_notes.xml:518 #, no-c-format msgid "Allow adding points at precision distance with TopoGeo_addPoint" msgstr "" #. Tag: para -#: release_notes.xml:424 +#: release_notes.xml:519 #, no-c-format -msgid "#1968, Fix missing edge from toTopoGeom return" +msgid "#1968, Fix missing edge from toTopoGeom return" msgstr "" #. Tag: para -#: release_notes.xml:427 +#: release_notes.xml:522 #, no-c-format -msgid "#2186, gui progress bar updates too frequent" +msgid "#2186, gui progress bar updates too frequent" msgstr "" #. Tag: para -#: release_notes.xml:431 +#: release_notes.xml:526 #, no-c-format -msgid "#2267, Server crash from analyze table" +msgid "#2267, Server crash from analyze table" msgstr "" #. Tag: para -#: release_notes.xml:432 +#: release_notes.xml:527 #, no-c-format -msgid "#2277, potential segfault removed" +msgid "#2277, potential segfault removed" msgstr "" #. Tag: para -#: release_notes.xml:435 +#: release_notes.xml:530 #, no-c-format -msgid "#2359, Incorrect handling of schema for overview constraints" +msgid "#2359, Incorrect handling of schema for overview constraints" msgstr "" #. Tag: para -#: release_notes.xml:437 +#: release_notes.xml:532 #, no-c-format -msgid "#2372, Cannot parse space-padded KML coordinates" +msgid "#2372, Cannot parse space-padded KML coordinates" msgstr "" #. Tag: para -#: release_notes.xml:438 +#: release_notes.xml:533 #, no-c-format msgid "Fix build with systemwide liblwgeom installed" msgstr "" #. Tag: para -#: release_notes.xml:439 +#: release_notes.xml:534 #, no-c-format -msgid "#2383, Fix unsafe use of \\' in warning message" +msgid "#2383, Fix unsafe use of \\' in warning message" msgstr "" #. Tag: para -#: release_notes.xml:440 +#: release_notes.xml:535 #, no-c-format -msgid "#2410, Fix segmentize of collinear curve" +msgid "#2410, Fix segmentize of collinear curve" msgstr "" #. Tag: para -#: release_notes.xml:441 +#: release_notes.xml:536 #, no-c-format -msgid "#2412, ST_LineToCurve support for lines with less than 4 vertices" +msgid "#2412, ST_LineToCurve support for lines with less than 4 vertices" msgstr "" #. Tag: para -#: release_notes.xml:442 +#: release_notes.xml:537 #, no-c-format -msgid "#2415, ST_Multi support for COMPOUNDCURVE and CURVEPOLYGON" +msgid "#2415, ST_Multi support for COMPOUNDCURVE and CURVEPOLYGON" msgstr "" #. Tag: para -#: release_notes.xml:443 +#: release_notes.xml:538 #, no-c-format -msgid "#2420, ST_LineToCurve: require at least 8 edges to define a full circle" +msgid "#2420, ST_LineToCurve: require at least 8 edges to define a full circle" msgstr "" #. Tag: para -#: release_notes.xml:444 +#: release_notes.xml:539 #, no-c-format -msgid "#2423, ST_LineToCurve: require all arc edges to form the same angle" +msgid "#2423, ST_LineToCurve: require all arc edges to form the same angle" msgstr "" #. Tag: para -#: release_notes.xml:445 +#: release_notes.xml:540 #, no-c-format -msgid "#2424, ST_CurveToLine: add support for COMPOUNDCURVE in MULTICURVE" +msgid "#2424, ST_CurveToLine: add support for COMPOUNDCURVE in MULTICURVE" msgstr "" #. Tag: para -#: release_notes.xml:446 +#: release_notes.xml:541 #, no-c-format -msgid "#2427, Make sure to retain first point of curves on ST_CurveToLine" +msgid "#2427, Make sure to retain first point of curves on ST_CurveToLine" msgstr "" #. Tag: para -#: release_notes.xml:450 +#: release_notes.xml:545 #, no-c-format -msgid "#2269, Avoid uselessly detoasting full geometries on ANALYZE" +msgid "#2269, Avoid uselessly detoasting full geometries on ANALYZE" msgstr "" #. Tag: title -#: release_notes.xml:459 +#: release_notes.xml:554 #, no-c-format msgid "Release 2.0.3" msgstr "" #. Tag: para -#: release_notes.xml:460 +#: release_notes.xml:555 #, no-c-format msgid "Release date: 2013/03/01" msgstr "" #. Tag: para -#: release_notes.xml:461 +#: release_notes.xml:556 #, no-c-format msgid "This is a bug fix release, addressing issues that have been filed since the 2.0.2 release. If you are using PostGIS 2.0+ a soft upgrade is required. For users of PostGIS 1.5 or below, a hard upgrade is required." msgstr "" #. Tag: para -#: release_notes.xml:465 +#: release_notes.xml:560 #, no-c-format -msgid "#2134, Make sure to process SRS before passing it off to GDAL functions" +msgid "#2134, Make sure to process SRS before passing it off to GDAL functions" msgstr "" #. Tag: para -#: release_notes.xml:466 +#: release_notes.xml:561 #, no-c-format msgid "Fix various memory leaks in liblwgeom" msgstr "" #. Tag: para -#: release_notes.xml:467 +#: release_notes.xml:562 #, no-c-format -msgid "#2173, Fix robustness issue in splitting a line with own vertex also affecting topology building (#2172)" +msgid "#2173, Fix robustness issue in splitting a line with own vertex also affecting topology building (#2172)" msgstr "" #. Tag: para -#: release_notes.xml:468 +#: release_notes.xml:563 #, no-c-format -msgid "#2174, Fix usage of wrong function lwpoly_free()" +msgid "#2174, Fix usage of wrong function lwpoly_free()" msgstr "" #. Tag: para -#: release_notes.xml:469 +#: release_notes.xml:564 #, no-c-format -msgid "#2176, Fix robustness issue with ST_ChangeEdgeGeom" +msgid "#2176, Fix robustness issue with ST_ChangeEdgeGeom" msgstr "" #. Tag: para -#: release_notes.xml:470 +#: release_notes.xml:565 #, no-c-format -msgid "#2184, Properly copy topologies with Z value" +msgid "#2184, Properly copy topologies with Z value" msgstr "" #. Tag: para -#: release_notes.xml:471 +#: release_notes.xml:566 #, no-c-format msgid "postgis_restore.pl support for mixed case geometry column name in dumps" msgstr "" #. Tag: para -#: release_notes.xml:473 +#: release_notes.xml:568 #, no-c-format -msgid "#2216, More memory errors in MultiPolygon GeoJSON parsing (with holes)" +msgid "#2216, More memory errors in MultiPolygon GeoJSON parsing (with holes)" msgstr "" #. Tag: para -#: release_notes.xml:474 +#: release_notes.xml:569 #, no-c-format msgid "Fix Memory leak in GeoJSON parser" msgstr "" #. Tag: para -#: release_notes.xml:479 +#: release_notes.xml:574 #, no-c-format msgid "Speedup ST_ChangeEdgeGeom" msgstr "" #. Tag: title -#: release_notes.xml:483 +#: release_notes.xml:578 #, no-c-format msgid "Release 2.0.2" msgstr "" #. Tag: para -#: release_notes.xml:484 +#: release_notes.xml:579 #, no-c-format msgid "Release date: 2012/12/03" msgstr "" #. Tag: para -#: release_notes.xml:485 +#: release_notes.xml:580 #, no-c-format msgid "This is a bug fix release, addressing issues that have been filed since the 2.0.1 release." msgstr "" #. Tag: para -#: release_notes.xml:488 +#: release_notes.xml:583 #, no-c-format -msgid "#1287, Drop of \"gist_geometry_ops\" broke a few clients package of legacy_gist.sql for these cases" +msgid "#1287, Drop of \"gist_geometry_ops\" broke a few clients package of legacy_gist.sql for these cases" msgstr "" #. Tag: para -#: release_notes.xml:490 +#: release_notes.xml:585 #, no-c-format -msgid "#1391, Errors during upgrade from 1.5" +msgid "#1391, Errors during upgrade from 1.5" msgstr "" #. Tag: para -#: release_notes.xml:491 +#: release_notes.xml:586 #, no-c-format -msgid "#1828, Poor selectivity estimate on ST_DWithin" +msgid "#1828, Poor selectivity estimate on ST_DWithin" msgstr "" #. Tag: para -#: release_notes.xml:492 +#: release_notes.xml:587 #, no-c-format -msgid "#1838, error importing tiger/line data" +msgid "#1838, error importing tiger/line data" msgstr "" #. Tag: para -#: release_notes.xml:493 +#: release_notes.xml:588 #, no-c-format -msgid "#1869, ST_AsBinary is not unique added to legacy_minor/legacy.sql scripts" +msgid "#1869, ST_AsBinary is not unique added to legacy_minor/legacy.sql scripts" msgstr "" #. Tag: para -#: release_notes.xml:494 +#: release_notes.xml:589 #, no-c-format -msgid "#1885, Missing field from tabblock table in tiger2010 census_loader.sql" +msgid "#1885, Missing field from tabblock table in tiger2010 census_loader.sql" msgstr "" #. Tag: para -#: release_notes.xml:495 +#: release_notes.xml:590 #, no-c-format -msgid "#1891, Use LDFLAGS environment when building liblwgeom" +msgid "#1891, Use LDFLAGS environment when building liblwgeom" msgstr "" #. Tag: para -#: release_notes.xml:496 +#: release_notes.xml:591 #, no-c-format -msgid "#1900, Fix pgsql2shp for big-endian systems" +msgid "#1900, Fix pgsql2shp for big-endian systems" msgstr "" #. Tag: para -#: release_notes.xml:497 +#: release_notes.xml:592 #, no-c-format -msgid "#1932, Fix raster2pgsql for invalid syntax for setting index tablespace" +msgid "#1932, Fix raster2pgsql for invalid syntax for setting index tablespace" msgstr "" #. Tag: para -#: release_notes.xml:499 +#: release_notes.xml:594 #, no-c-format -msgid "#1955, ST_ModEdgeHeal and ST_NewEdgeHeal for doubly connected edges" +msgid "#1955, ST_ModEdgeHeal and ST_NewEdgeHeal for doubly connected edges" msgstr "" #. Tag: para -#: release_notes.xml:502 +#: release_notes.xml:597 #, no-c-format -msgid "#1978, wrong answer calculating length of closed circular arc (circle)" +msgid "#1978, wrong answer calculating length of closed circular arc (circle)" msgstr "" #. Tag: para -#: release_notes.xml:503 +#: release_notes.xml:598 #, no-c-format -msgid "#1981, Remove unused but set variables as found with gcc 4.6+" +msgid "#1981, Remove unused but set variables as found with gcc 4.6+" msgstr "" #. Tag: para -#: release_notes.xml:504 +#: release_notes.xml:599 #, no-c-format -msgid "#1987, Restore 1.5.x behaviour of ST_Simplify" +msgid "#1987, Restore 1.5.x behaviour of ST_Simplify" msgstr "" #. Tag: para -#: release_notes.xml:507 +#: release_notes.xml:602 #, no-c-format -msgid "#1991, geocode really slow on PostgreSQL 9.2" +msgid "#1991, geocode really slow on PostgreSQL 9.2" msgstr "" #. Tag: para -#: release_notes.xml:509 +#: release_notes.xml:604 #, no-c-format -msgid "#1998, Fix ST_{Mod,New}EdgeHeal joining edges sharing both endpoints" +msgid "#1998, Fix ST_{Mod,New}EdgeHeal joining edges sharing both endpoints" msgstr "" #. Tag: para -#: release_notes.xml:510 +#: release_notes.xml:605 #, no-c-format -msgid "#2001, ST_CurveToLine has no effect if the geometry doesn't actually contain an arc" +msgid "#2001, ST_CurveToLine has no effect if the geometry doesn't actually contain an arc" msgstr "" #. Tag: para -#: release_notes.xml:511 +#: release_notes.xml:606 #, no-c-format -msgid "#2015, ST_IsEmpty('POLYGON(EMPTY)') returns False" +msgid "#2015, ST_IsEmpty('POLYGON(EMPTY)') returns False" msgstr "" #. Tag: para -#: release_notes.xml:513 +#: release_notes.xml:608 #, no-c-format -msgid "#2025, Fix side location conflict at TopoGeo_AddLineString" +msgid "#2025, Fix side location conflict at TopoGeo_AddLineString" msgstr "" #. Tag: para -#: release_notes.xml:514 +#: release_notes.xml:609 #, no-c-format -msgid "#2026, improve performance of distance calculations" +msgid "#2026, improve performance of distance calculations" msgstr "" #. Tag: para -#: release_notes.xml:515 +#: release_notes.xml:610 #, no-c-format -msgid "#2033, Fix adding a splitting point into a 2.5d topology" +msgid "#2033, Fix adding a splitting point into a 2.5d topology" msgstr "" #. Tag: para -#: release_notes.xml:516 +#: release_notes.xml:611 #, no-c-format -msgid "#2051, Fix excess of precision in ST_AsGeoJSON output" +msgid "#2051, Fix excess of precision in ST_AsGeoJSON output" msgstr "" #. Tag: para -#: release_notes.xml:517 +#: release_notes.xml:612 #, no-c-format -msgid "#2052, Fix buffer overflow in lwgeom_to_geojson" +msgid "#2052, Fix buffer overflow in lwgeom_to_geojson" msgstr "" #. Tag: para -#: release_notes.xml:518 +#: release_notes.xml:613 #, no-c-format -msgid "#2056, Fixed lack of SRID check of raster and geometry in ST_SetValue()" +msgid "#2056, Fixed lack of SRID check of raster and geometry in ST_SetValue()" msgstr "" #. Tag: para -#: release_notes.xml:520 +#: release_notes.xml:615 #, no-c-format -msgid "#2060, Fix \"dimension\" check violation by GetTopoGeomElementArray" +msgid "#2060, Fix \"dimension\" check violation by GetTopoGeomElementArray" msgstr "" #. Tag: para -#: release_notes.xml:521 +#: release_notes.xml:616 #, no-c-format -msgid "#2072, Removed outdated checks preventing ST_Intersects(raster) from working on out-db bands" +msgid "#2072, Removed outdated checks preventing ST_Intersects(raster) from working on out-db bands" msgstr "" #. Tag: para -#: release_notes.xml:523 +#: release_notes.xml:618 #, no-c-format -msgid "#2077, Fixed incorrect answers from ST_Hillshade(raster)" +msgid "#2077, Fixed incorrect answers from ST_Hillshade(raster)" msgstr "" #. Tag: para -#: release_notes.xml:524 +#: release_notes.xml:619 #, no-c-format -msgid "#2092, Namespace issue with ST_GeomFromKML,ST_GeomFromGML for libxml 2.8+" +msgid "#2092, Namespace issue with ST_GeomFromKML,ST_GeomFromGML for libxml 2.8+" msgstr "" #. Tag: para -#: release_notes.xml:525 +#: release_notes.xml:620 #, no-c-format -msgid "#2099, Fix double free on exception in ST_OffsetCurve" +msgid "#2099, Fix double free on exception in ST_OffsetCurve" msgstr "" #. Tag: para -#: release_notes.xml:526 +#: release_notes.xml:621 #, no-c-format -msgid "#2100, ST_AsRaster() may not return raster with specified pixel type" +msgid "#2100, ST_AsRaster() may not return raster with specified pixel type" msgstr "" #. Tag: para -#: release_notes.xml:527 +#: release_notes.xml:622 #, no-c-format -msgid "#2108, Ensure ST_Line_Interpolate_Point always returns POINT" +msgid "#2108, Ensure ST_Line_Interpolate_Point always returns POINT" msgstr "" #. Tag: para -#: release_notes.xml:528 +#: release_notes.xml:623 #, no-c-format -msgid "#2109, Ensure ST_Centroid always returns POINT" +msgid "#2109, Ensure ST_Centroid always returns POINT" msgstr "" #. Tag: para -#: release_notes.xml:529 +#: release_notes.xml:624 #, no-c-format -msgid "#2117, Ensure ST_PointOnSurface always returns POINT" +msgid "#2117, Ensure ST_PointOnSurface always returns POINT" msgstr "" #. Tag: para -#: release_notes.xml:530 +#: release_notes.xml:625 #, no-c-format -msgid "#2129, Fix SRID in ST_Homogenize output with collection input" +msgid "#2129, Fix SRID in ST_Homogenize output with collection input" msgstr "" #. Tag: para -#: release_notes.xml:531 +#: release_notes.xml:626 #, no-c-format -msgid "#2130, Fix memory error in MultiPolygon GeoJson parsing" +msgid "#2130, Fix memory error in MultiPolygon GeoJson parsing" msgstr "" #. Tag: para -#: release_notes.xml:533 +#: release_notes.xml:628 #, no-c-format msgid "Update URL of Maven jar" msgstr "" #. Tag: para -#: release_notes.xml:537 +#: release_notes.xml:632 #, no-c-format -msgid "#1581, ST_Clip(raster, ...) no longer imposes NODATA on a band if the corresponding band from the source raster did not have NODATA" +msgid "#1581, ST_Clip(raster, ...) no longer imposes NODATA on a band if the corresponding band from the source raster did not have NODATA" msgstr "" #. Tag: para -#: release_notes.xml:539 +#: release_notes.xml:634 #, no-c-format -msgid "#1928, Accept array properties in GML input multi-geom input (Kashif Rasul and Shoaib Burq / SpacialDB)" +msgid "#1928, Accept array properties in GML input multi-geom input (Kashif Rasul and Shoaib Burq / SpacialDB)" msgstr "" #. Tag: para -#: release_notes.xml:541 +#: release_notes.xml:636 #, no-c-format -msgid "#2082, Add indices on start_node and end_node of topology edge tables" +msgid "#2082, Add indices on start_node and end_node of topology edge tables" msgstr "" #. Tag: para -#: release_notes.xml:542 +#: release_notes.xml:637 #, no-c-format -msgid "#2087, Speedup topology.GetRingEdges using a recursive CTE" +msgid "#2087, Speedup topology.GetRingEdges using a recursive CTE" msgstr "" #. Tag: title -#: release_notes.xml:546 +#: release_notes.xml:641 #, no-c-format msgid "Release 2.0.1" msgstr "" #. Tag: para -#: release_notes.xml:547 +#: release_notes.xml:642 #, no-c-format msgid "Release date: 2012/06/22" msgstr "" #. Tag: para -#: release_notes.xml:548 +#: release_notes.xml:643 #, no-c-format msgid "This is a bug fix release, addressing issues that have been filed since the 2.0.0 release." msgstr "" #. Tag: para -#: release_notes.xml:551 +#: release_notes.xml:646 #, no-c-format -msgid "#1264, fix st_dwithin(geog, geog, 0)." +msgid "#1264, fix st_dwithin(geog, geog, 0)." msgstr "" #. Tag: para -#: release_notes.xml:552 +#: release_notes.xml:647 #, no-c-format -msgid "#1468 shp2pgsql-gui table column schema get shifted" +msgid "#1468 shp2pgsql-gui table column schema get shifted" msgstr "" #. Tag: para -#: release_notes.xml:553 +#: release_notes.xml:648 #, no-c-format -msgid "#1694, fix building with clang. (vince)" +msgid "#1694, fix building with clang. (vince)" msgstr "" #. Tag: para -#: release_notes.xml:554 +#: release_notes.xml:649 #, no-c-format -msgid "#1708, improve restore of pre-PostGIS 2.0 backups." +msgid "#1708, improve restore of pre-PostGIS 2.0 backups." msgstr "" #. Tag: para -#: release_notes.xml:555 +#: release_notes.xml:650 #, no-c-format -msgid "#1714, more robust handling of high topology tolerance." +msgid "#1714, more robust handling of high topology tolerance." msgstr "" #. Tag: para -#: release_notes.xml:556 +#: release_notes.xml:651 #, no-c-format -msgid "#1755, ST_GeographyFromText support for higher dimensions." +msgid "#1755, ST_GeographyFromText support for higher dimensions." msgstr "" #. Tag: para -#: release_notes.xml:557 +#: release_notes.xml:652 #, no-c-format -msgid "#1759, loading transformed shapefiles in raster enabled db." +msgid "#1759, loading transformed shapefiles in raster enabled db." msgstr "" #. Tag: para -#: release_notes.xml:558 +#: release_notes.xml:653 #, no-c-format -msgid "#1761, handling of subdatasets in NetCDF, HDF4 and HDF5 in raster2pgsql." +msgid "#1761, handling of subdatasets in NetCDF, HDF4 and HDF5 in raster2pgsql." msgstr "" #. Tag: para -#: release_notes.xml:559 +#: release_notes.xml:654 #, no-c-format -msgid "#1763, topology.toTopoGeom use with custom search_path." +msgid "#1763, topology.toTopoGeom use with custom search_path." msgstr "" #. Tag: para -#: release_notes.xml:560 +#: release_notes.xml:655 #, no-c-format -msgid "#1766, don't let ST_RemEdge* destroy peripheral TopoGeometry objects." +msgid "#1766, don't let ST_RemEdge* destroy peripheral TopoGeometry objects." msgstr "" #. Tag: para -#: release_notes.xml:561 +#: release_notes.xml:656 #, no-c-format -msgid "#1774, Clearer error on setting an edge geometry to an invalid one." +msgid "#1774, Clearer error on setting an edge geometry to an invalid one." msgstr "" #. Tag: para -#: release_notes.xml:562 +#: release_notes.xml:657 #, no-c-format -msgid "#1775, ST_ChangeEdgeGeom collision detection with 2-vertex target." +msgid "#1775, ST_ChangeEdgeGeom collision detection with 2-vertex target." msgstr "" #. Tag: para -#: release_notes.xml:563 +#: release_notes.xml:658 #, no-c-format -msgid "#1776, fix ST_SymDifference(empty, geom) to return geom." +msgid "#1776, fix ST_SymDifference(empty, geom) to return geom." msgstr "" #. Tag: para -#: release_notes.xml:564 +#: release_notes.xml:659 #, no-c-format -msgid "#1779, install SQL comment files." +msgid "#1779, install SQL comment files." msgstr "" #. Tag: para -#: release_notes.xml:565 +#: release_notes.xml:660 #, no-c-format -msgid "#1782, fix spatial reference string handling in raster." +msgid "#1782, fix spatial reference string handling in raster." msgstr "" #. Tag: para -#: release_notes.xml:566 +#: release_notes.xml:661 #, no-c-format -msgid "#1789, fix false edge-node crossing report in ValidateTopology." +msgid "#1789, fix false edge-node crossing report in ValidateTopology." msgstr "" #. Tag: para -#: release_notes.xml:567 +#: release_notes.xml:662 #, no-c-format -msgid "#1790, fix toTopoGeom handling of duplicated primitives." +msgid "#1790, fix toTopoGeom handling of duplicated primitives." msgstr "" #. Tag: para -#: release_notes.xml:568 +#: release_notes.xml:663 #, no-c-format -msgid "#1791, fix ST_Azimuth with very close but distinct points." +msgid "#1791, fix ST_Azimuth with very close but distinct points." msgstr "" #. Tag: para -#: release_notes.xml:569 +#: release_notes.xml:664 #, no-c-format -msgid "#1797, fix (ValidateTopology(xxx)).* syntax calls." +msgid "#1797, fix (ValidateTopology(xxx)).* syntax calls." msgstr "" #. Tag: para -#: release_notes.xml:570 +#: release_notes.xml:665 #, no-c-format -msgid "#1805, put back the 900913 SRID entry." +msgid "#1805, put back the 900913 SRID entry." msgstr "" #. Tag: para -#: release_notes.xml:571 +#: release_notes.xml:666 #, no-c-format -msgid "#1813, Only show readable relations in metadata tables." +msgid "#1813, Only show readable relations in metadata tables." msgstr "" #. Tag: para -#: release_notes.xml:572 +#: release_notes.xml:667 #, no-c-format -msgid "#1819, fix floating point issues with ST_World2RasterCoord and ST_Raster2WorldCoord variants." +msgid "#1819, fix floating point issues with ST_World2RasterCoord and ST_Raster2WorldCoord variants." msgstr "" #. Tag: para -#: release_notes.xml:574 +#: release_notes.xml:669 #, no-c-format -msgid "#1820 compilation on 9.2beta1." +msgid "#1820 compilation on 9.2beta1." msgstr "" #. Tag: para -#: release_notes.xml:575 +#: release_notes.xml:670 #, no-c-format -msgid "#1822, topology load on PostgreSQL 9.2beta1." +msgid "#1822, topology load on PostgreSQL 9.2beta1." msgstr "" #. Tag: para -#: release_notes.xml:576 +#: release_notes.xml:671 #, no-c-format -msgid "#1825, fix prepared geometry cache lookup" +msgid "#1825, fix prepared geometry cache lookup" msgstr "" #. Tag: para -#: release_notes.xml:577 +#: release_notes.xml:672 #, no-c-format -msgid "#1829, fix uninitialized read in GeoJSON parser" +msgid "#1829, fix uninitialized read in GeoJSON parser" msgstr "" #. Tag: para -#: release_notes.xml:578 +#: release_notes.xml:673 #, no-c-format -msgid "#1834, revise postgis extension to only backup user specified spatial_ref_sys" +msgid "#1834, revise postgis extension to only backup user specified spatial_ref_sys" msgstr "" #. Tag: para -#: release_notes.xml:582 +#: release_notes.xml:677 #, no-c-format -msgid "#1851, fix spatial_ref_system parameters for EPSG:3844" +msgid "#1851, fix spatial_ref_system parameters for EPSG:3844" msgstr "" #. Tag: para -#: release_notes.xml:583 +#: release_notes.xml:678 #, no-c-format -msgid "#1857, fix failure to detect endpoint mismatch in ST_AddEdge*Face*" +msgid "#1857, fix failure to detect endpoint mismatch in ST_AddEdge*Face*" msgstr "" #. Tag: para -#: release_notes.xml:584 +#: release_notes.xml:679 #, no-c-format -msgid "#1865, data loss in postgis_restore.pl when data rows have leading dashes." +msgid "#1865, data loss in postgis_restore.pl when data rows have leading dashes." msgstr "" #. Tag: para -#: release_notes.xml:586 +#: release_notes.xml:681 #, no-c-format -msgid "#1867, catch invalid topology name passed to topogeo_add*" +msgid "#1867, catch invalid topology name passed to topogeo_add*" msgstr "" #. Tag: para -#: release_notes.xml:588 +#: release_notes.xml:683 #, no-c-format -msgid "#1873, fix ptarray_locate_point to return interpolated Z/M values for on-the-line case" +msgid "#1873, fix ptarray_locate_point to return interpolated Z/M values for on-the-line case" msgstr "" #. Tag: para -#: release_notes.xml:592 +#: release_notes.xml:687 #, no-c-format -msgid "#1881, shp2pgsql-gui -- editing a field sometimes triggers removing row" +msgid "#1881, shp2pgsql-gui -- editing a field sometimes triggers removing row" msgstr "" #. Tag: para -#: release_notes.xml:594 +#: release_notes.xml:689 #, no-c-format -msgid "#1883, Geocoder install fails trying to run create_census_base_tables() (Brian Panulla)" +msgid "#1883, Geocoder install fails trying to run create_census_base_tables() (Brian Panulla)" msgstr "" #. Tag: para -#: release_notes.xml:599 +#: release_notes.xml:694 #, no-c-format msgid "More detailed exception message from topology editing functions." msgstr "" #. Tag: para -#: release_notes.xml:600 +#: release_notes.xml:695 #, no-c-format -msgid "#1786, improved build dependencies" +msgid "#1786, improved build dependencies" msgstr "" #. Tag: para -#: release_notes.xml:601 +#: release_notes.xml:696 #, no-c-format -msgid "#1806, speedup of ST_BuildArea, ST_MakeValid and ST_GetFaceGeometry." +msgid "#1806, speedup of ST_BuildArea, ST_MakeValid and ST_GetFaceGeometry." msgstr "" #. Tag: para -#: release_notes.xml:602 +#: release_notes.xml:697 #, no-c-format -msgid "#1812, Add lwgeom_normalize in LIBLWGEOM for more stable testing." +msgid "#1812, Add lwgeom_normalize in LIBLWGEOM for more stable testing." msgstr "" #. Tag: title -#: release_notes.xml:606 +#: release_notes.xml:701 #, no-c-format msgid "Release 2.0.0" msgstr "" #. Tag: para -#: release_notes.xml:607 +#: release_notes.xml:702 #, no-c-format msgid "Release date: 2012/04/03" msgstr "" #. Tag: para -#: release_notes.xml:608 +#: release_notes.xml:703 #, no-c-format msgid "This is a major release. A hard upgrade is required. Yes this means a full dump reload and some special preparations if you are using obsolete functions. Refer to for details on upgrading. Refer to for more details and changed/new functions." msgstr "" #. Tag: title -#: release_notes.xml:612 +#: release_notes.xml:707 #, no-c-format msgid "Testers - Our unsung heroes" msgstr "" #. Tag: para -#: release_notes.xml:613 +#: release_notes.xml:708 #, no-c-format msgid "We are most indebted to the numerous members in the PostGIS community who were brave enough to test out the new features in this release. No major release can be successful without these folk." msgstr "" #. Tag: para -#: release_notes.xml:616 +#: release_notes.xml:711 #, no-c-format msgid "Below are those who have been most valiant, provided very detailed and thorough bug reports, and detailed analysis." msgstr "" #. Tag: member -#: release_notes.xml:620 +#: release_notes.xml:715 #, no-c-format msgid "Andrea Peri - Lots of testing on topology, checking for correctness" msgstr "" #. Tag: member -#: release_notes.xml:621 +#: release_notes.xml:716 #, no-c-format msgid "Andreas Forø Tollefsen - raster testing" msgstr "" #. Tag: member -#: release_notes.xml:622 +#: release_notes.xml:717 #, no-c-format msgid "Chris English - topology stress testing loader functions" msgstr "" #. Tag: member -#: release_notes.xml:623 +#: release_notes.xml:718 #, no-c-format msgid "Salvatore Larosa - topology robustness testing" msgstr "" #. Tag: member -#: release_notes.xml:624 +#: release_notes.xml:719 #, no-c-format msgid "Brian Hamlin - Benchmarking (also experimental experimental branches before they are folded into core) , general testing of various pieces including Tiger and Topology. Testing on various server VMs" msgstr "" #. Tag: member -#: release_notes.xml:629 +#: release_notes.xml:724 #, no-c-format msgid "Mike Pease - Tiger geocoder testing - very detailed reports of issues" msgstr "" #. Tag: member -#: release_notes.xml:630 +#: release_notes.xml:725 #, no-c-format msgid "Tom van Tilburg - raster testing" msgstr "" #. Tag: para -#: release_notes.xml:635 +#: release_notes.xml:730 #, no-c-format -msgid "#722, #302, Most deprecated functions removed (over 250 functions) (Regina Obe, Paul Ramsey)" +msgid "#722, #302, Most deprecated functions removed (over 250 functions) (Regina Obe, Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:636 +#: release_notes.xml:731 #, no-c-format msgid "Unknown SRID changed from -1 to 0. (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:637 +#: release_notes.xml:732 #, no-c-format msgid "-- (most deprecated in 1.2) removed non-ST variants buffer, length, intersects (and internal functions renamed) etc." msgstr "" #. Tag: para -#: release_notes.xml:639 +#: release_notes.xml:734 #, no-c-format msgid "-- If you have been using deprecated functions CHANGE your apps or suffer the consequences. If you don't see a function documented -- it ain't supported or it is an internal function. Some constraints in older tables were built with deprecated functions. If you restore you may need to rebuild table constraints with populate_geometry_columns(). If you have applications or tools that rely on deprecated functions, please refer to for more details." msgstr "" #. Tag: para -#: release_notes.xml:644 +#: release_notes.xml:739 #, no-c-format -msgid "#944 geometry_columns is now a view instead of a table (Paul Ramsey, Regina Obe) for tables created the old way reads (srid, type, dims) constraints for geometry columns created with type modifiers reads rom column definition" +msgid "#944 geometry_columns is now a view instead of a table (Paul Ramsey, Regina Obe) for tables created the old way reads (srid, type, dims) constraints for geometry columns created with type modifiers reads rom column definition" msgstr "" #. Tag: para -#: release_notes.xml:649 +#: release_notes.xml:744 #, no-c-format -msgid "#1081, #1082, #1084, #1088 - Mangement functions support typmod geometry column creation functions now default to typmod creation (Regina Obe)" +msgid "#1081, #1082, #1084, #1088 - Mangement functions support typmod geometry column creation functions now default to typmod creation (Regina Obe)" msgstr "" #. Tag: para -#: release_notes.xml:652 +#: release_notes.xml:747 #, no-c-format -msgid "#1083 probe_geometry_columns(), rename_geometry_table_constraints(), fix_geometry_columns(); removed - now obsolete with geometry_column view (Regina Obe)" +msgid "#1083 probe_geometry_columns(), rename_geometry_table_constraints(), fix_geometry_columns(); removed - now obsolete with geometry_column view (Regina Obe)" msgstr "" #. Tag: para -#: release_notes.xml:656 +#: release_notes.xml:751 #, no-c-format -msgid "#817 Renaming old 3D functions to the convention ST_3D (Nicklas Avén)" +msgid "#817 Renaming old 3D functions to the convention ST_3D (Nicklas Avén)" msgstr "" #. Tag: para -#: release_notes.xml:657 +#: release_notes.xml:752 #, no-c-format -msgid "#548 (sorta), ST_NumGeometries,ST_GeometryN now returns 1 (or the geometry) instead of null for single geometries (Sandro Santilli, Maxime van Noppen)" +msgid "#548 (sorta), ST_NumGeometries,ST_GeometryN now returns 1 (or the geometry) instead of null for single geometries (Sandro Santilli, Maxime van Noppen)" msgstr "" #. Tag: ulink -#: release_notes.xml:662 +#: release_notes.xml:757 #, no-c-format msgid "KNN Gist index based centroid (<->) and box (<#>) distance operators (Paul Ramsey / funded by Vizzuality)" msgstr "" #. Tag: para -#: release_notes.xml:663 +#: release_notes.xml:758 #, no-c-format msgid "Support for TIN and PolyHedralSurface and enhancement of many functions to support 3D (Olivier Courtin / Oslandia)" msgstr "" #. Tag: para -#: release_notes.xml:664 +#: release_notes.xml:759 #, no-c-format msgid "Raster support integrated and documented (Pierre Racine, Jorge Arévalo, Mateusz Loskot, Sandro Santilli, David Zwarg, Regina Obe, Bborie Park) (Company developer and funding: University Laval, Deimos Space, CadCorp, Michigan Tech Research Institute, Azavea, Paragon Corporation, UC Davis Center for Vectorborne Diseases)" msgstr "" #. Tag: para -#: release_notes.xml:667 +#: release_notes.xml:762 #, no-c-format msgid "Making spatial indexes 3D aware - in progress (Paul Ramsey, Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:668 +#: release_notes.xml:763 #, no-c-format msgid "Topology support improved (more functions), documented, testing (Sandro Santilli / Faunalia for RT-SIGTA), Andrea Peri, Regina Obe, Jose Carlos Martinez Llari" msgstr "" #. Tag: para -#: release_notes.xml:669 +#: release_notes.xml:764 #, no-c-format msgid "3D relationship and measurement support functions (Nicklas Avén)" msgstr "" #. Tag: para -#: release_notes.xml:670 +#: release_notes.xml:765 #, no-c-format msgid "ST_3DDistance, ST_3DClosestPoint, ST_3DIntersects, ST_3DShortestLine and more..." msgstr "" #. Tag: para -#: release_notes.xml:671 +#: release_notes.xml:766 #, no-c-format msgid "N-Dimensional spatial indexes (Paul Ramsey / OpenGeo)" msgstr "" #. Tag: para -#: release_notes.xml:672 +#: release_notes.xml:767 #, no-c-format msgid "ST_Split (Sandro Santilli / Faunalia for RT-SIGTA)" msgstr "" #. Tag: para -#: release_notes.xml:673 +#: release_notes.xml:768 #, no-c-format msgid "ST_IsValidDetail (Sandro Santilli / Faunalia for RT-SIGTA)" msgstr "" #. Tag: para -#: release_notes.xml:674 +#: release_notes.xml:769 #, no-c-format msgid "ST_MakeValid (Sandro Santilli / Faunalia for RT-SIGTA)" msgstr "" #. Tag: para -#: release_notes.xml:675 +#: release_notes.xml:770 #, no-c-format msgid "ST_RemoveRepeatedPoints (Sandro Santilli / Faunalia for RT-SIGTA)" msgstr "" #. Tag: para -#: release_notes.xml:676 +#: release_notes.xml:771 #, no-c-format msgid "ST_GeometryN and ST_NumGeometries support for non-collections (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:677 +#: release_notes.xml:772 #, no-c-format msgid "ST_IsCollection (Sandro Santilli, Maxime van Noppen)" msgstr "" #. Tag: para -#: release_notes.xml:678 +#: release_notes.xml:773 #, no-c-format msgid "ST_SharedPaths (Sandro Santilli / Faunalia for RT-SIGTA)" msgstr "" #. Tag: para -#: release_notes.xml:679 +#: release_notes.xml:774 #, no-c-format msgid "ST_Snap (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:680 +#: release_notes.xml:775 #, no-c-format msgid "ST_RelateMatch (Sandro Santilli / Faunalia for RT-SIGTA)" msgstr "" #. Tag: para -#: release_notes.xml:681 +#: release_notes.xml:776 #, no-c-format msgid "ST_ConcaveHull (Regina Obe and Leo Hsu / Paragon Corporation)" msgstr "" #. Tag: para -#: release_notes.xml:682 +#: release_notes.xml:777 #, no-c-format msgid "ST_UnaryUnion (Sandro Santilli / Faunalia for RT-SIGTA)" msgstr "" #. Tag: para -#: release_notes.xml:683 +#: release_notes.xml:778 #, no-c-format msgid "ST_AsX3D (Regina Obe / Arrival 3D funding)" msgstr "" #. Tag: para -#: release_notes.xml:684 +#: release_notes.xml:779 #, no-c-format msgid "ST_OffsetCurve (Sandro Santilli, Rafal Magda)" msgstr "" #. Tag: ulink -#: release_notes.xml:685 +#: release_notes.xml:780 #, no-c-format msgid "ST_GeomFromGeoJSON (Kashif Rasul, Paul Ramsey / Vizzuality funding)" msgstr "" #. Tag: para -#: release_notes.xml:689 +#: release_notes.xml:784 #, no-c-format msgid "Made shape file loader tolerant of truncated multibyte values found in some free worldwide shapefiles (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:690 +#: release_notes.xml:785 #, no-c-format msgid "Lots of bug fixes and enhancements to shp2pgsql Beefing up regression tests for loaders Reproject support for both geometry and geography during import (Jeff Adams / Azavea, Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:694 +#: release_notes.xml:789 #, no-c-format msgid "pgsql2shp conversion from predefined list (Loic Dachary / Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:696 +#: release_notes.xml:791 #, no-c-format msgid "Shp-pgsql GUI loader - support loading multiple files at a time. (Mark Leslie)" msgstr "" #. Tag: para -#: release_notes.xml:697 +#: release_notes.xml:792 #, no-c-format msgid "Extras - upgraded tiger_geocoder from using old TIGER format to use new TIGER shp and file structure format (Stephen Frost)" msgstr "" #. Tag: para -#: release_notes.xml:698 +#: release_notes.xml:793 #, no-c-format msgid "Extras - revised tiger_geocoder to work with TIGER census 2010 data, addition of reverse geocoder function, various bug fixes, accuracy enhancements, limit max result return, speed improvements, loading routines. (Regina Obe, Leo Hsu / Paragon Corporation / funding provided by Hunter Systems Group)" msgstr "" #. Tag: para -#: release_notes.xml:701 +#: release_notes.xml:796 #, no-c-format msgid "Overall Documentation proofreading and corrections. (Kasif Rasul)" msgstr "" #. Tag: para -#: release_notes.xml:702 +#: release_notes.xml:797 #, no-c-format msgid "Cleanup PostGIS JDBC classes, revise to use Maven build. (Maria Arias de Reyna, Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:706 +#: release_notes.xml:801 #, no-c-format -msgid "#1335 ST_AddPoint returns incorrect result on Linux (Even Rouault)" +msgid "#1335 ST_AddPoint returns incorrect result on Linux (Even Rouault)" msgstr "" #. Tag: title -#: release_notes.xml:709 +#: release_notes.xml:804 #, no-c-format msgid "Release specific credits" msgstr "" #. Tag: para -#: release_notes.xml:710 +#: release_notes.xml:805 #, no-c-format msgid "We thank U.S Department of State Human Information Unit (HIU) and Vizzuality for general monetary support to get PostGIS 2.0 out the door." msgstr "" #. Tag: title -#: release_notes.xml:715 +#: release_notes.xml:810 #, no-c-format msgid "Release 1.5.4" msgstr "" #. Tag: para -#: release_notes.xml:716 +#: release_notes.xml:811 #, no-c-format msgid "Release date: 2012/05/07" msgstr "" #. Tag: para -#: release_notes.xml:717 +#: release_notes.xml:812 #, no-c-format msgid "This is a bug fix release, addressing issues that have been filed since the 1.5.3 release." msgstr "" #. Tag: para -#: release_notes.xml:720 +#: release_notes.xml:815 #, no-c-format -msgid "#547, ST_Contains memory problems (Sandro Santilli)" +msgid "#547, ST_Contains memory problems (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:721 +#: release_notes.xml:816 #, no-c-format -msgid "#621, Problem finding intersections with geography (Paul Ramsey)" +msgid "#621, Problem finding intersections with geography (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:722 +#: release_notes.xml:817 #, no-c-format -msgid "#627, PostGIS/PostgreSQL process die on invalid geometry (Paul Ramsey)" +msgid "#627, PostGIS/PostgreSQL process die on invalid geometry (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:723 +#: release_notes.xml:818 #, no-c-format -msgid "#810, Increase accuracy of area calculation (Paul Ramsey)" +msgid "#810, Increase accuracy of area calculation (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:724 +#: release_notes.xml:819 #, no-c-format -msgid "#852, improve spatial predicates robustness (Sandro Santilli, Nicklas Avén)" +msgid "#852, improve spatial predicates robustness (Sandro Santilli, Nicklas Avén)" msgstr "" #. Tag: para -#: release_notes.xml:725 +#: release_notes.xml:820 #, no-c-format -msgid "#877, ST_Estimated_Extent returns NULL on empty tables (Sandro Santilli)" +msgid "#877, ST_Estimated_Extent returns NULL on empty tables (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:726 +#: release_notes.xml:821 #, no-c-format -msgid "#1028, ST_AsSVG kills whole postgres server when fails (Paul Ramsey)" +msgid "#1028, ST_AsSVG kills whole postgres server when fails (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:727 +#: release_notes.xml:822 #, no-c-format -msgid "#1056, Fix boxes of arcs and circle stroking code (Paul Ramsey)" +msgid "#1056, Fix boxes of arcs and circle stroking code (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:728 +#: release_notes.xml:823 #, no-c-format -msgid "#1121, populate_geometry_columns using deprecated functions (Regin Obe, Paul Ramsey)" +msgid "#1121, populate_geometry_columns using deprecated functions (Regin Obe, Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:729 +#: release_notes.xml:824 #, no-c-format -msgid "#1135, improve testsuite predictability (Andreas 'ads' Scherbaum)" +msgid "#1135, improve testsuite predictability (Andreas 'ads' Scherbaum)" msgstr "" #. Tag: para -#: release_notes.xml:730 +#: release_notes.xml:825 #, no-c-format -msgid "#1146, images generator crashes (bronaugh)" +msgid "#1146, images generator crashes (bronaugh)" msgstr "" #. Tag: para -#: release_notes.xml:731 +#: release_notes.xml:826 #, no-c-format -msgid "#1170, North Pole intersection fails (Paul Ramsey)" +msgid "#1170, North Pole intersection fails (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:732 +#: release_notes.xml:827 #, no-c-format -msgid "#1179, ST_AsText crash with bad value (kjurka)" +msgid "#1179, ST_AsText crash with bad value (kjurka)" msgstr "" #. Tag: para -#: release_notes.xml:733 +#: release_notes.xml:828 #, no-c-format -msgid "#1184, honour DESTDIR in documentation Makefile (Bryce L Nordgren)" +msgid "#1184, honour DESTDIR in documentation Makefile (Bryce L Nordgren)" msgstr "" #. Tag: para -#: release_notes.xml:734 +#: release_notes.xml:829 #, no-c-format -msgid "#1227, server crash on invalid GML" +msgid "#1227, server crash on invalid GML" msgstr "" #. Tag: para -#: release_notes.xml:735 +#: release_notes.xml:830 #, no-c-format -msgid "#1252, SRID appearing in WKT (Paul Ramsey)" +msgid "#1252, SRID appearing in WKT (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:736 +#: release_notes.xml:831 #, no-c-format -msgid "#1264, st_dwithin(g, g, 0) doesn't work (Paul Ramsey)" +msgid "#1264, st_dwithin(g, g, 0) doesn't work (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:737 +#: release_notes.xml:832 #, no-c-format -msgid "#1344, allow exporting tables with invalid geometries (Sandro Santilli)" +msgid "#1344, allow exporting tables with invalid geometries (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:738 +#: release_notes.xml:833 #, no-c-format -msgid "#1389, wrong proj4text for SRID 31300 and 31370 (Paul Ramsey)" +msgid "#1389, wrong proj4text for SRID 31300 and 31370 (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:739 +#: release_notes.xml:834 #, no-c-format -msgid "#1406, shp2pgsql crashes when loading into geography (Sandro Santilli)" +msgid "#1406, shp2pgsql crashes when loading into geography (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:740 +#: release_notes.xml:835 #, no-c-format -msgid "#1595, fixed SRID redundancy in ST_Line_SubString (Sandro Santilli)" +msgid "#1595, fixed SRID redundancy in ST_Line_SubString (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:741 +#: release_notes.xml:836 #, no-c-format -msgid "#1596, check SRID in UpdateGeometrySRID (Mike Toews, Sandro Santilli)" +msgid "#1596, check SRID in UpdateGeometrySRID (Mike Toews, Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:742 +#: release_notes.xml:837 #, no-c-format -msgid "#1602, fix ST_Polygonize to retain Z (Sandro Santilli)" +msgid "#1602, fix ST_Polygonize to retain Z (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:743 +#: release_notes.xml:838 #, no-c-format -msgid "#1697, fix crash with EMPTY entries in GiST index (Paul Ramsey)" +msgid "#1697, fix crash with EMPTY entries in GiST index (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:744 +#: release_notes.xml:839 #, no-c-format -msgid "#1772, fix ST_Line_Locate_Point with collapsed input (Sandro Santilli)" +msgid "#1772, fix ST_Line_Locate_Point with collapsed input (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:745 +#: release_notes.xml:840 #, no-c-format -msgid "#1799, Protect ST_Segmentize from max_length=0 (Sandro Santilli)" +msgid "#1799, Protect ST_Segmentize from max_length=0 (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:746 +#: release_notes.xml:841 #, no-c-format msgid "Alter parameter order in 900913 (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:747 +#: release_notes.xml:842 #, no-c-format msgid "Support builds with \"gmake\" (Greg Troxel)" msgstr "" #. Tag: title -#: release_notes.xml:752 +#: release_notes.xml:847 #, no-c-format msgid "Release 1.5.3" msgstr "" #. Tag: para -#: release_notes.xml:753 +#: release_notes.xml:848 #, no-c-format msgid "Release date: 2011/06/25" msgstr "" #. Tag: para -#: release_notes.xml:754 +#: release_notes.xml:849 #, no-c-format msgid "This is a bug fix release, addressing issues that have been filed since the 1.5.2 release. If you are running PostGIS 1.3+, a soft upgrade is sufficient otherwise a hard upgrade is recommended." msgstr "" #. Tag: para -#: release_notes.xml:758 +#: release_notes.xml:853 #, no-c-format -msgid "#1056, produce correct bboxes for arc geometries, fixes index errors (Paul Ramsey)" +msgid "#1056, produce correct bboxes for arc geometries, fixes index errors (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:760 +#: release_notes.xml:855 #, no-c-format -msgid "#1007, ST_IsValid crash fix requires GEOS 3.3.0+ or 3.2.3+ (Sandro Santilli, reported by Birgit Laggner)" +msgid "#1007, ST_IsValid crash fix requires GEOS 3.3.0+ or 3.2.3+ (Sandro Santilli, reported by Birgit Laggner)" msgstr "" #. Tag: para -#: release_notes.xml:762 +#: release_notes.xml:857 #, no-c-format -msgid "#940, support for PostgreSQL 9.1 beta 1 (Regina Obe, Paul Ramsey, patch submitted by stl)" +msgid "#940, support for PostgreSQL 9.1 beta 1 (Regina Obe, Paul Ramsey, patch submitted by stl)" msgstr "" #. Tag: para -#: release_notes.xml:764 +#: release_notes.xml:859 #, no-c-format -msgid "#845, ST_Intersects precision error (Sandro Santilli, Nicklas Avén) Reported by cdestigter" +msgid "#845, ST_Intersects precision error (Sandro Santilli, Nicklas Avén) Reported by cdestigter" msgstr "" #. Tag: para -#: release_notes.xml:766 +#: release_notes.xml:861 #, no-c-format -msgid "#884, Unstable results with ST_Within, ST_Intersects (Chris Hodgson)" +msgid "#884, Unstable results with ST_Within, ST_Intersects (Chris Hodgson)" msgstr "" #. Tag: para -#: release_notes.xml:767 +#: release_notes.xml:862 #, no-c-format -msgid "#779, shp2pgsql -S option seems to fail on points (Jeff Adams)" +msgid "#779, shp2pgsql -S option seems to fail on points (Jeff Adams)" msgstr "" #. Tag: para -#: release_notes.xml:768 +#: release_notes.xml:863 #, no-c-format -msgid "#666, ST_DumpPoints is not null safe (Regina Obe)" +msgid "#666, ST_DumpPoints is not null safe (Regina Obe)" msgstr "" #. Tag: para -#: release_notes.xml:769 +#: release_notes.xml:864 #, no-c-format -msgid "#631, Update NZ projections for grid transformation support (jpalmer)" +msgid "#631, Update NZ projections for grid transformation support (jpalmer)" msgstr "" #. Tag: para -#: release_notes.xml:770 +#: release_notes.xml:865 #, no-c-format -msgid "#630, Peculiar Null treatment in arrays in ST_Collect (Chris Hodgson) Reported by David Bitner" +msgid "#630, Peculiar Null treatment in arrays in ST_Collect (Chris Hodgson) Reported by David Bitner" msgstr "" #. Tag: para -#: release_notes.xml:772 +#: release_notes.xml:867 #, no-c-format -msgid "#624, Memory leak in ST_GeogFromText (ryang, Paul Ramsey)" +msgid "#624, Memory leak in ST_GeogFromText (ryang, Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:773 +#: release_notes.xml:868 #, no-c-format -msgid "#609, Bad source code in manual section 5.2 Java Clients (simoc, Regina Obe)" +msgid "#609, Bad source code in manual section 5.2 Java Clients (simoc, Regina Obe)" msgstr "" #. Tag: para -#: release_notes.xml:774 +#: release_notes.xml:869 #, no-c-format -msgid "#604, shp2pgsql usage touchups (Mike Toews, Paul Ramsey)" +msgid "#604, shp2pgsql usage touchups (Mike Toews, Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:775 +#: release_notes.xml:870 #, no-c-format -msgid "#573 ST_Union fails on a group of linestrings Not a PostGIS bug, fixed in GEOS 3.3.0" +msgid "#573 ST_Union fails on a group of linestrings Not a PostGIS bug, fixed in GEOS 3.3.0" msgstr "" #. Tag: para -#: release_notes.xml:777 +#: release_notes.xml:872 #, no-c-format -msgid "#457 ST_CollectionExtract returns non-requested type (Nicklas Avén, Paul Ramsey)" +msgid "#457 ST_CollectionExtract returns non-requested type (Nicklas Avén, Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:779 +#: release_notes.xml:874 #, no-c-format -msgid "#441 ST_AsGeoJson Bbox on GeometryCollection error (Olivier Courtin)" +msgid "#441 ST_AsGeoJson Bbox on GeometryCollection error (Olivier Courtin)" msgstr "" #. Tag: para -#: release_notes.xml:780 +#: release_notes.xml:875 #, no-c-format -msgid "#411 Ability to backup invalid geometries (Sando Santilli) Reported by Regione Toscana" +msgid "#411 Ability to backup invalid geometries (Sando Santilli) Reported by Regione Toscana" msgstr "" #. Tag: para -#: release_notes.xml:782 +#: release_notes.xml:877 #, no-c-format -msgid "#409 ST_AsSVG - degraded (Olivier Courtin) Reported by Sdikiy" +msgid "#409 ST_AsSVG - degraded (Olivier Courtin) Reported by Sdikiy" msgstr "" #. Tag: para -#: release_notes.xml:784 +#: release_notes.xml:879 #, no-c-format -msgid "#373 Documentation syntax error in hard upgrade (Paul Ramsey) Reported by psvensso" +msgid "#373 Documentation syntax error in hard upgrade (Paul Ramsey) Reported by psvensso" msgstr "" #. Tag: title -#: release_notes.xml:790 +#: release_notes.xml:885 #, no-c-format msgid "Release 1.5.2" msgstr "" #. Tag: para -#: release_notes.xml:791 +#: release_notes.xml:886 #, no-c-format msgid "Release date: 2010/09/27" msgstr "" #. Tag: para -#: release_notes.xml:792 +#: release_notes.xml:887 #, no-c-format msgid "This is a bug fix release, addressing issues that have been filed since the 1.5.1 release. If you are running PostGIS 1.3+, a soft upgrade is sufficient otherwise a hard upgrade is recommended." msgstr "" #. Tag: para -#: release_notes.xml:796 +#: release_notes.xml:891 #, no-c-format msgid "Loader: fix handling of empty (0-verticed) geometries in shapefiles. (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:797 +#: release_notes.xml:892 #, no-c-format -msgid "#536, Geography ST_Intersects, ST_Covers, ST_CoveredBy and Geometry ST_Equals not using spatial index (Regina Obe, Nicklas Aven)" +msgid "#536, Geography ST_Intersects, ST_Covers, ST_CoveredBy and Geometry ST_Equals not using spatial index (Regina Obe, Nicklas Aven)" msgstr "" #. Tag: para -#: release_notes.xml:798 +#: release_notes.xml:893 #, no-c-format -msgid "#573, Improvement to ST_Contains geography (Paul Ramsey)" +msgid "#573, Improvement to ST_Contains geography (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:799 +#: release_notes.xml:894 #, no-c-format msgid "Loader: Add support for command-q shutdown in Mac GTK build (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:800 +#: release_notes.xml:895 #, no-c-format -msgid "#393, Loader: Add temporary patch for large DBF files (Maxime Guillaud, Paul Ramsey)" +msgid "#393, Loader: Add temporary patch for large DBF files (Maxime Guillaud, Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:801 +#: release_notes.xml:896 #, no-c-format -msgid "#507, Fix wrong OGC URN in GeoJSON and GML output (Olivier Courtin)" +msgid "#507, Fix wrong OGC URN in GeoJSON and GML output (Olivier Courtin)" msgstr "" #. Tag: para -#: release_notes.xml:802 +#: release_notes.xml:897 #, no-c-format msgid "spatial_ref_sys.sql Add datum conversion for projection SRID 3021 (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:803 +#: release_notes.xml:898 #, no-c-format msgid "Geography - remove crash for case when all geographies are out of the estimate (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:804 +#: release_notes.xml:899 #, no-c-format -msgid "#469, Fix for array_aggregation error (Greg Stark, Paul Ramsey)" +msgid "#469, Fix for array_aggregation error (Greg Stark, Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:805 +#: release_notes.xml:900 #, no-c-format -msgid "#532, Temporary geography tables showing up in other user sessions (Paul Ramsey)" +msgid "#532, Temporary geography tables showing up in other user sessions (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:806 +#: release_notes.xml:901 #, no-c-format -msgid "#562, ST_Dwithin errors for large geographies (Paul Ramsey)" +msgid "#562, ST_Dwithin errors for large geographies (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:807 +#: release_notes.xml:902 #, no-c-format -msgid "#513, shape loading GUI tries to make spatial index when loading DBF only mode (Paul Ramsey)" +msgid "#513, shape loading GUI tries to make spatial index when loading DBF only mode (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:808 +#: release_notes.xml:903 #, no-c-format -msgid "#527, shape loading GUI should always append log messages (Mark Cave-Ayland)" +msgid "#527, shape loading GUI should always append log messages (Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:809 +#: release_notes.xml:904 #, no-c-format -msgid "#504, shp2pgsql should rename xmin/xmax fields (Sandro Santilli)" +msgid "#504, shp2pgsql should rename xmin/xmax fields (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:810 +#: release_notes.xml:905 #, no-c-format -msgid "#458, postgis_comments being installed in contrib instead of version folder (Mark Cave-Ayland)" +msgid "#458, postgis_comments being installed in contrib instead of version folder (Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:811 +#: release_notes.xml:906 #, no-c-format -msgid "#474, Analyzing a table with geography column crashes server (Paul Ramsey)" +msgid "#474, Analyzing a table with geography column crashes server (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:812 +#: release_notes.xml:907 #, no-c-format -msgid "#581, LWGEOM-expand produces inconsistent results (Mark Cave-Ayland)" +msgid "#581, LWGEOM-expand produces inconsistent results (Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:813 +#: release_notes.xml:908 #, no-c-format -msgid "#513, Add dbf filter to shp2pgsql-gui and allow uploading dbf only (Paul Ramsey)" +msgid "#513, Add dbf filter to shp2pgsql-gui and allow uploading dbf only (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:814 +#: release_notes.xml:909 #, no-c-format msgid "Fix further build issues against PostgreSQL 9.0 (Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:815 +#: release_notes.xml:910 #, no-c-format -msgid "#572, Password whitespace for Shape File (Mark Cave-Ayland)" +msgid "#572, Password whitespace for Shape File (Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:816 +#: release_notes.xml:911 #, no-c-format -msgid "#603, shp2pgsql: \"-w\" produces invalid WKT for MULTI* objects. (Mark Cave-Ayland)" +msgid "#603, shp2pgsql: \"-w\" produces invalid WKT for MULTI* objects. (Mark Cave-Ayland)" msgstr "" #. Tag: title -#: release_notes.xml:821 +#: release_notes.xml:916 #, no-c-format msgid "Release 1.5.1" msgstr "" #. Tag: para -#: release_notes.xml:822 +#: release_notes.xml:917 #, no-c-format msgid "Release date: 2010/03/11" msgstr "" #. Tag: para -#: release_notes.xml:823 +#: release_notes.xml:918 #, no-c-format msgid "This is a bug fix release, addressing issues that have been filed since the 1.4.1 release. If you are running PostGIS 1.3+, a soft upgrade is sufficient otherwise a hard upgrade is recommended." msgstr "" #. Tag: para -#: release_notes.xml:827 +#: release_notes.xml:922 #, no-c-format -msgid "#410, update embedded bbox when applying ST_SetPoint, ST_AddPoint ST_RemovePoint to a linestring (Paul Ramsey)" +msgid "#410, update embedded bbox when applying ST_SetPoint, ST_AddPoint ST_RemovePoint to a linestring (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:828 +#: release_notes.xml:923 #, no-c-format -msgid "#411, allow dumping tables with invalid geometries (Sandro Santilli, for Regione Toscana-SIGTA)" +msgid "#411, allow dumping tables with invalid geometries (Sandro Santilli, for Regione Toscana-SIGTA)" msgstr "" #. Tag: para -#: release_notes.xml:829 +#: release_notes.xml:924 #, no-c-format -msgid "#414, include geography_columns view when running upgrade scripts (Paul Ramsey)" +msgid "#414, include geography_columns view when running upgrade scripts (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:830 +#: release_notes.xml:925 #, no-c-format -msgid "#419, allow support for multilinestring in ST_Line_Substring (Paul Ramsey, for Lidwala Consulting Engineers)" +msgid "#419, allow support for multilinestring in ST_Line_Substring (Paul Ramsey, for Lidwala Consulting Engineers)" msgstr "" #. Tag: para -#: release_notes.xml:831 +#: release_notes.xml:926 #, no-c-format -msgid "#421, fix computed string length in ST_AsGML() (Olivier Courtin)" +msgid "#421, fix computed string length in ST_AsGML() (Olivier Courtin)" msgstr "" #. Tag: para -#: release_notes.xml:832 +#: release_notes.xml:927 #, no-c-format -msgid "#441, fix GML generation with heterogeneous collections (Olivier Courtin)" +msgid "#441, fix GML generation with heterogeneous collections (Olivier Courtin)" msgstr "" #. Tag: para -#: release_notes.xml:833 +#: release_notes.xml:928 #, no-c-format -msgid "#443, incorrect coordinate reversal in GML 3 generation (Olivier Courtin)" +msgid "#443, incorrect coordinate reversal in GML 3 generation (Olivier Courtin)" msgstr "" #. Tag: para -#: release_notes.xml:834 +#: release_notes.xml:929 #, no-c-format -msgid "#450, #451, wrong area calculation for geography features that cross the date line (Paul Ramsey)" +msgid "#450, #451, wrong area calculation for geography features that cross the date line (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:835 +#: release_notes.xml:930 #, no-c-format msgid "Ensure support for upcoming 9.0 PgSQL release (Paul Ramsey)" msgstr "" #. Tag: title -#: release_notes.xml:840 +#: release_notes.xml:935 #, no-c-format msgid "Release 1.5.0" msgstr "" #. Tag: para -#: release_notes.xml:841 +#: release_notes.xml:936 #, no-c-format msgid "Release date: 2010/02/04" msgstr "" #. Tag: para -#: release_notes.xml:842 +#: release_notes.xml:937 #, no-c-format msgid "This release provides support for geographic coordinates (lat/lon) via a new GEOGRAPHY type. Also performance enhancements, new input format support (GML,KML) and general upkeep." msgstr "" #. Tag: title -#: release_notes.xml:845 release_notes.xml:912 +#: release_notes.xml:940 release_notes.xml:1007 #, no-c-format msgid "API Stability" msgstr "" #. Tag: para -#: release_notes.xml:846 +#: release_notes.xml:941 #, no-c-format msgid "The public API of PostGIS will not change during minor (0.0.X) releases." msgstr "" #. Tag: para -#: release_notes.xml:847 +#: release_notes.xml:942 #, no-c-format msgid "The definition of the =~ operator has changed from an exact geometric equality check to a bounding box equality check." msgstr "" #. Tag: title -#: release_notes.xml:851 release_notes.xml:917 +#: release_notes.xml:946 release_notes.xml:1012 #, no-c-format msgid "Compatibility" msgstr "" #. Tag: para -#: release_notes.xml:852 +#: release_notes.xml:947 #, no-c-format msgid "GEOS, Proj4, and LibXML2 are now mandatory dependencies" msgstr "" #. Tag: para -#: release_notes.xml:853 +#: release_notes.xml:948 #, no-c-format msgid "The library versions below are the minimum requirements for PostGIS 1.5" msgstr "" #. Tag: para -#: release_notes.xml:854 +#: release_notes.xml:949 #, no-c-format msgid "PostgreSQL 8.3 and higher on all platforms" msgstr "" #. Tag: para -#: release_notes.xml:855 +#: release_notes.xml:950 #, no-c-format msgid "GEOS 3.1 and higher only (GEOS 3.2+ to take advantage of all features)" msgstr "" #. Tag: para -#: release_notes.xml:856 +#: release_notes.xml:951 #, no-c-format msgid "LibXML2 2.5+ related to new ST_GeomFromGML/KML functionality" msgstr "" #. Tag: para -#: release_notes.xml:857 +#: release_notes.xml:952 #, no-c-format msgid "Proj4 4.5 and higher only" msgstr "" #. Tag: para -#: release_notes.xml:863 +#: release_notes.xml:958 #, no-c-format -msgid "Added Hausdorff distance calculations (#209) (Vincent Picavet)" +msgid "Added Hausdorff distance calculations (#209) (Vincent Picavet)" msgstr "" #. Tag: para -#: release_notes.xml:864 +#: release_notes.xml:959 #, no-c-format msgid "Added parameters argument to ST_Buffer operation to support one-sided buffering and other buffering styles (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:865 +#: release_notes.xml:960 #, no-c-format msgid "Addition of other Distance related visualization and analysis functions (Nicklas Aven)" msgstr "" #. Tag: para -#: release_notes.xml:867 +#: release_notes.xml:962 #, no-c-format msgid "ST_ClosestPoint" msgstr "" #. Tag: para -#: release_notes.xml:868 +#: release_notes.xml:963 #, no-c-format msgid "ST_DFullyWithin" msgstr "" #. Tag: para -#: release_notes.xml:869 +#: release_notes.xml:964 #, no-c-format msgid "ST_LongestLine" msgstr "" #. Tag: para -#: release_notes.xml:870 +#: release_notes.xml:965 #, no-c-format msgid "ST_MaxDistance" msgstr "" #. Tag: para -#: release_notes.xml:871 +#: release_notes.xml:966 #, no-c-format msgid "ST_ShortestLine" msgstr "" #. Tag: para -#: release_notes.xml:873 +#: release_notes.xml:968 #, no-c-format msgid "ST_DumpPoints (Maxime van Noppen)" msgstr "" #. Tag: para -#: release_notes.xml:874 +#: release_notes.xml:969 #, no-c-format msgid "KML, GML input via ST_GeomFromGML and ST_GeomFromKML (Olivier Courtin)" msgstr "" #. Tag: para -#: release_notes.xml:875 +#: release_notes.xml:970 #, no-c-format msgid "Extract homogeneous collection with ST_CollectionExtract (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:876 +#: release_notes.xml:971 #, no-c-format msgid "Add measure values to an existing linestring with ST_AddMeasure (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:877 +#: release_notes.xml:972 #, no-c-format msgid "History table implementation in utils (George Silva)" msgstr "" #. Tag: para -#: release_notes.xml:878 +#: release_notes.xml:973 #, no-c-format msgid "Geography type and supporting functions" msgstr "" #. Tag: para -#: release_notes.xml:880 +#: release_notes.xml:975 #, no-c-format msgid "Spherical algorithms (Dave Skea)" msgstr "" #. Tag: para -#: release_notes.xml:881 +#: release_notes.xml:976 #, no-c-format msgid "Object/index implementation (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:882 +#: release_notes.xml:977 #, no-c-format msgid "Selectivity implementation (Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:883 +#: release_notes.xml:978 #, no-c-format msgid "Serializations to KML, GML and JSON (Olivier Courtin)" msgstr "" #. Tag: para -#: release_notes.xml:884 +#: release_notes.xml:979 #, no-c-format msgid "ST_Area, ST_Distance, ST_DWithin, ST_GeogFromText, ST_GeogFromWKB, ST_Intersects, ST_Covers, ST_Buffer (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:890 +#: release_notes.xml:985 #, no-c-format msgid "Performance improvements to ST_Distance (Nicklas Aven)" msgstr "" #. Tag: para -#: release_notes.xml:891 +#: release_notes.xml:986 #, no-c-format msgid "Documentation updates and improvements (Regina Obe, Kevin Neufeld)" msgstr "" #. Tag: para -#: release_notes.xml:892 +#: release_notes.xml:987 #, no-c-format msgid "Testing and quality control (Regina Obe)" msgstr "" #. Tag: para -#: release_notes.xml:893 +#: release_notes.xml:988 #, no-c-format msgid "PostGIS 1.5 support PostgreSQL 8.5 trunk (Guillaume Lelarge)" msgstr "" #. Tag: para -#: release_notes.xml:894 +#: release_notes.xml:989 #, no-c-format msgid "Win32 support and improvement of core shp2pgsql-gui (Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:895 +#: release_notes.xml:990 #, no-c-format msgid "In place 'make check' support (Paul Ramsey)" msgstr "" #. Tag: title -#: release_notes.xml:899 release_notes.xml:965 release_notes.xml:1150 release_notes.xml:1201 release_notes.xml:1252 release_notes.xml:1386 release_notes.xml:1452 release_notes.xml:1562 release_notes.xml:1669 release_notes.xml:1789 release_notes.xml:1854 release_notes.xml:1901 +#: release_notes.xml:994 release_notes.xml:1060 release_notes.xml:1245 release_notes.xml:1296 release_notes.xml:1347 release_notes.xml:1481 release_notes.xml:1547 release_notes.xml:1657 release_notes.xml:1764 release_notes.xml:1884 release_notes.xml:1949 release_notes.xml:1996 #, no-c-format msgid "Bug fixes" msgstr "" #. Tag: ulink -#: release_notes.xml:900 +#: release_notes.xml:995 #, no-c-format msgid "http://trac.osgeo.org/postgis/query?status=closed&milestone=PostGIS+1.5.0&order=priority" msgstr "" #. Tag: title -#: release_notes.xml:905 +#: release_notes.xml:1000 #, no-c-format msgid "Release 1.4.0" msgstr "" #. Tag: para -#: release_notes.xml:906 +#: release_notes.xml:1001 #, no-c-format msgid "Release date: 2009/07/24" msgstr "" #. Tag: para -#: release_notes.xml:907 +#: release_notes.xml:1002 #, no-c-format msgid "This release provides performance enhancements, improved internal structures and testing, new features, and upgraded documentation. If you are running PostGIS 1.1+, a soft upgrade is sufficient otherwise a hard upgrade is recommended." msgstr "" #. Tag: para -#: release_notes.xml:913 +#: release_notes.xml:1008 #, no-c-format msgid "As of the 1.4 release series, the public API of PostGIS will not change during minor releases." msgstr "" #. Tag: para -#: release_notes.xml:918 +#: release_notes.xml:1013 #, no-c-format msgid "The versions below are the *minimum* requirements for PostGIS 1.4" msgstr "" #. Tag: para -#: release_notes.xml:919 +#: release_notes.xml:1014 #, no-c-format msgid "PostgreSQL 8.2 and higher on all platforms" msgstr "" #. Tag: para -#: release_notes.xml:920 +#: release_notes.xml:1015 #, no-c-format msgid "GEOS 3.0 and higher only" msgstr "" #. Tag: para -#: release_notes.xml:921 +#: release_notes.xml:1016 #, no-c-format msgid "PROJ4 4.5 and higher only" msgstr "" #. Tag: para -#: release_notes.xml:926 +#: release_notes.xml:1021 #, no-c-format msgid "ST_Union() uses high-speed cascaded union when compiled against GEOS 3.1+ (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:928 +#: release_notes.xml:1023 #, no-c-format msgid "ST_ContainsProperly() requires GEOS 3.1+" msgstr "" #. Tag: para -#: release_notes.xml:929 +#: release_notes.xml:1024 #, no-c-format msgid "ST_Intersects(), ST_Contains(), ST_Within() use high-speed cached prepared geometry against GEOS 3.1+ (Paul Ramsey / funded by Zonar Systems)" msgstr "" #. Tag: para -#: release_notes.xml:930 +#: release_notes.xml:1025 #, no-c-format msgid "Vastly improved documentation and reference manual (Regina Obe & Kevin Neufeld)" msgstr "" #. Tag: para -#: release_notes.xml:931 +#: release_notes.xml:1026 #, no-c-format msgid "Figures and diagram examples in the reference manual (Kevin Neufeld)" msgstr "" #. Tag: para -#: release_notes.xml:932 +#: release_notes.xml:1027 #, no-c-format msgid "ST_IsValidReason() returns readable explanations for validity failures (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:933 +#: release_notes.xml:1028 #, no-c-format msgid "ST_GeoHash() returns a geohash.org signature for geometries (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:934 +#: release_notes.xml:1029 #, no-c-format msgid "GTK+ multi-platform GUI for shape file loading (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:935 +#: release_notes.xml:1030 #, no-c-format msgid "ST_LineCrossingDirection() returns crossing directions (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:936 +#: release_notes.xml:1031 #, no-c-format msgid "ST_LocateBetweenElevations() returns sub-string based on Z-ordinate. (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:937 +#: release_notes.xml:1032 #, no-c-format msgid "Geometry parser returns explicit error message about location of syntax errors (Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:938 +#: release_notes.xml:1033 #, no-c-format msgid "ST_AsGeoJSON() return JSON formatted geometry (Olivier Courtin)" msgstr "" #. Tag: para -#: release_notes.xml:939 +#: release_notes.xml:1034 #, no-c-format msgid "Populate_Geometry_Columns() -- automatically add records to geometry_columns for TABLES and VIEWS (Kevin Neufeld)" msgstr "" #. Tag: para -#: release_notes.xml:940 +#: release_notes.xml:1035 #, no-c-format msgid "ST_MinimumBoundingCircle() -- returns the smallest circle polygon that can encompass a geometry (Bruce Rindahl)" msgstr "" #. Tag: para -#: release_notes.xml:945 +#: release_notes.xml:1040 #, no-c-format msgid "Core geometry system moved into independent library, liblwgeom. (Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:946 +#: release_notes.xml:1041 #, no-c-format msgid "New build system uses PostgreSQL \"pgxs\" build bootstrapper. (Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:947 +#: release_notes.xml:1042 #, no-c-format msgid "Debugging framework formalized and simplified. (Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:948 +#: release_notes.xml:1043 #, no-c-format msgid "All build-time #defines generated at configure time and placed in headers for easier cross-platform support (Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:949 +#: release_notes.xml:1044 #, no-c-format msgid "Logging framework formalized and simplified (Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:950 +#: release_notes.xml:1045 #, no-c-format msgid "Expanded and more stable support for CIRCULARSTRING, COMPOUNDCURVE and CURVEPOLYGON, better parsing, wider support in functions (Mark Leslie & Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:951 +#: release_notes.xml:1046 #, no-c-format msgid "Improved support for OpenSolaris builds (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:952 +#: release_notes.xml:1047 #, no-c-format msgid "Improved support for MSVC builds (Mateusz Loskot)" msgstr "" #. Tag: para -#: release_notes.xml:953 +#: release_notes.xml:1048 #, no-c-format msgid "Updated KML support (Olivier Courtin)" msgstr "" #. Tag: para -#: release_notes.xml:954 +#: release_notes.xml:1049 #, no-c-format msgid "Unit testing framework for liblwgeom (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:955 +#: release_notes.xml:1050 #, no-c-format msgid "New testing framework to comprehensively exercise every PostGIS function (Regine Obe)" msgstr "" #. Tag: para -#: release_notes.xml:956 +#: release_notes.xml:1051 #, no-c-format msgid "Performance improvements to all geometry aggregate functions (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:957 +#: release_notes.xml:1052 #, no-c-format msgid "Support for the upcoming PostgreSQL 8.4 (Mark Cave-Ayland, Talha Bin Rizwan)" msgstr "" #. Tag: para -#: release_notes.xml:958 +#: release_notes.xml:1053 #, no-c-format msgid "Shp2pgsql and pgsql2shp re-worked to depend on the common parsing/unparsing code in liblwgeom (Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:959 +#: release_notes.xml:1054 #, no-c-format msgid "Use of PDF DbLatex to build PDF docs and preliminary instructions for build (Jean David Techer)" msgstr "" #. Tag: para -#: release_notes.xml:960 +#: release_notes.xml:1055 #, no-c-format msgid "Automated User documentation build (PDF and HTML) and Developer Doxygen Documentation (Kevin Neufeld)" msgstr "" #. Tag: para -#: release_notes.xml:961 +#: release_notes.xml:1056 #, no-c-format msgid "Automated build of document images using ImageMagick from WKT geometry text files (Kevin Neufeld)" msgstr "" #. Tag: para -#: release_notes.xml:962 +#: release_notes.xml:1057 #, no-c-format msgid "More attractive CSS for HTML documentation (Dane Springmeyer)" msgstr "" #. Tag: ulink -#: release_notes.xml:966 +#: release_notes.xml:1061 #, no-c-format msgid "http://trac.osgeo.org/postgis/query?status=closed&milestone=PostGIS+1.4.0&order=priority" msgstr "" #. Tag: title -#: release_notes.xml:971 +#: release_notes.xml:1066 #, no-c-format msgid "Release 1.3.6" msgstr "" #. Tag: para -#: release_notes.xml:972 +#: release_notes.xml:1067 #, no-c-format msgid "Release date: 2009/05/04" msgstr "" #. Tag: para -#: release_notes.xml:973 +#: release_notes.xml:1068 #, no-c-format msgid "If you are running PostGIS 1.1+, a soft upgrade is sufficient otherwise a hard upgrade is recommended. This release adds support for PostgreSQL 8.4, exporting prj files from the database with shape data, some crash fixes for shp2pgsql, and several small bug fixes in the handling of \"curve\" types, logical error importing dbf only files, improved error handling of AddGeometryColumns." msgstr "" #. Tag: title -#: release_notes.xml:980 +#: release_notes.xml:1075 #, no-c-format msgid "Release 1.3.5" msgstr "" #. Tag: para -#: release_notes.xml:981 +#: release_notes.xml:1076 #, no-c-format msgid "Release date: 2008/12/15" msgstr "" #. Tag: para -#: release_notes.xml:982 +#: release_notes.xml:1077 #, no-c-format msgid "If you are running PostGIS 1.1+, a soft upgrade is sufficient otherwise a hard upgrade is recommended. This release is a bug fix release to address a failure in ST_Force_Collection and related functions that critically affects using MapServer with LINE layers." msgstr "" #. Tag: title -#: release_notes.xml:989 +#: release_notes.xml:1084 #, no-c-format msgid "Release 1.3.4" msgstr "" #. Tag: para -#: release_notes.xml:990 +#: release_notes.xml:1085 #, no-c-format msgid "Release date: 2008/11/24" msgstr "" #. Tag: para -#: release_notes.xml:991 +#: release_notes.xml:1086 #, no-c-format msgid "This release adds support for GeoJSON output, building with PostgreSQL 8.4, improves documentation quality and output aesthetics, adds function-level SQL documentation, and improves performance for some spatial predicates (point-in-polygon tests)." msgstr "" #. Tag: para -#: release_notes.xml:996 +#: release_notes.xml:1091 #, no-c-format msgid "Bug fixes include removal of crashers in handling circular strings for many functions, some memory leaks removed, a linear referencing failure for measures on vertices, and more. See the NEWS file for details." msgstr "" #. Tag: title -#: release_notes.xml:1003 +#: release_notes.xml:1098 #, no-c-format msgid "Release 1.3.3" msgstr "" #. Tag: para -#: release_notes.xml:1005 +#: release_notes.xml:1100 #, no-c-format msgid "Release date: 2008/04/12" msgstr "" #. Tag: para -#: release_notes.xml:1007 +#: release_notes.xml:1102 #, no-c-format msgid "This release fixes bugs shp2pgsql, adds enhancements to SVG and KML support, adds a ST_SimplifyPreserveTopology function, makes the build more sensitive to GEOS versions, and fixes a handful of severe but rare failure cases." msgstr "" #. Tag: title -#: release_notes.xml:1014 +#: release_notes.xml:1109 #, no-c-format msgid "Release 1.3.2" msgstr "" #. Tag: para -#: release_notes.xml:1016 +#: release_notes.xml:1111 #, no-c-format msgid "Release date: 2007/12/01" msgstr "" #. Tag: para -#: release_notes.xml:1018 +#: release_notes.xml:1113 #, no-c-format msgid "This release fixes bugs in ST_EndPoint() and ST_Envelope, improves support for JDBC building and OS/X, and adds better support for GML output with ST_AsGML(), including GML3 output." msgstr "" #. Tag: title -#: release_notes.xml:1024 +#: release_notes.xml:1119 #, no-c-format msgid "Release 1.3.1" msgstr "" #. Tag: para -#: release_notes.xml:1026 +#: release_notes.xml:1121 #, no-c-format msgid "Release date: 2007/08/13" msgstr "" #. Tag: para -#: release_notes.xml:1028 +#: release_notes.xml:1123 #, no-c-format msgid "This release fixes some oversights in the previous release around version numbering, documentation, and tagging." msgstr "" #. Tag: title -#: release_notes.xml:1033 +#: release_notes.xml:1128 #, no-c-format msgid "Release 1.3.0" msgstr "" #. Tag: para -#: release_notes.xml:1035 +#: release_notes.xml:1130 #, no-c-format msgid "Release date: 2007/08/09" msgstr "" #. Tag: para -#: release_notes.xml:1037 +#: release_notes.xml:1132 #, no-c-format msgid "This release provides performance enhancements to the relational functions, adds new relational functions and begins the migration of our function names to the SQL-MM convention, using the spatial type (SP) prefix." msgstr "" #. Tag: title -#: release_notes.xml:1043 +#: release_notes.xml:1138 #, no-c-format msgid "Added Functionality" msgstr "" #. Tag: para -#: release_notes.xml:1045 +#: release_notes.xml:1140 #, no-c-format msgid "JDBC: Added Hibernate Dialect (thanks to Norman Barker)" msgstr "" #. Tag: para -#: release_notes.xml:1047 +#: release_notes.xml:1142 #, no-c-format msgid "Added ST_Covers and ST_CoveredBy relational functions. Description and justification of these functions can be found at http://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html" msgstr "" #. Tag: para -#: release_notes.xml:1051 +#: release_notes.xml:1146 #, no-c-format msgid "Added ST_DWithin relational function." msgstr "" #. Tag: title -#: release_notes.xml:1055 +#: release_notes.xml:1150 #, no-c-format msgid "Performance Enhancements" msgstr "" #. Tag: para -#: release_notes.xml:1057 +#: release_notes.xml:1152 #, no-c-format msgid "Added cached and indexed point-in-polygon short-circuits for the functions ST_Contains, ST_Intersects, ST_Within and ST_Disjoint" msgstr "" #. Tag: para -#: release_notes.xml:1060 +#: release_notes.xml:1155 #, no-c-format msgid "Added inline index support for relational functions (except ST_Disjoint)" msgstr "" #. Tag: title -#: release_notes.xml:1065 +#: release_notes.xml:1160 #, no-c-format msgid "Other Changes" msgstr "" #. Tag: para -#: release_notes.xml:1067 +#: release_notes.xml:1162 #, no-c-format msgid "Extended curved geometry support into the geometry accessor and some processing functions" msgstr "" #. Tag: para -#: release_notes.xml:1070 +#: release_notes.xml:1165 #, no-c-format msgid "Began migration of functions to the SQL-MM naming convention; using a spatial type (ST) prefix." msgstr "" #. Tag: para -#: release_notes.xml:1073 +#: release_notes.xml:1168 #, no-c-format msgid "Added initial support for PostgreSQL 8.3" msgstr "" #. Tag: title -#: release_notes.xml:1078 +#: release_notes.xml:1173 #, no-c-format msgid "Release 1.2.1" msgstr "" #. Tag: para -#: release_notes.xml:1080 +#: release_notes.xml:1175 #, no-c-format msgid "Release date: 2007/01/11" msgstr "" #. Tag: para -#: release_notes.xml:1082 +#: release_notes.xml:1177 #, no-c-format msgid "This release provides bug fixes in PostgreSQL 8.2 support and some small performance enhancements." msgstr "" #. Tag: title -#: release_notes.xml:1086 release_notes.xml:1114 release_notes.xml:2336 +#: release_notes.xml:1181 release_notes.xml:1209 release_notes.xml:2431 #, no-c-format msgid "Changes" msgstr "" #. Tag: para -#: release_notes.xml:1088 +#: release_notes.xml:1183 #, no-c-format msgid "Fixed point-in-polygon shortcut bug in Within()." msgstr "" #. Tag: para -#: release_notes.xml:1090 +#: release_notes.xml:1185 #, no-c-format msgid "Fixed PostgreSQL 8.2 NULL handling for indexes." msgstr "" #. Tag: para -#: release_notes.xml:1092 +#: release_notes.xml:1187 #, no-c-format msgid "Updated RPM spec files." msgstr "" #. Tag: para -#: release_notes.xml:1094 +#: release_notes.xml:1189 #, no-c-format msgid "Added short-circuit for Transform() in no-op case." msgstr "" #. Tag: para -#: release_notes.xml:1096 +#: release_notes.xml:1191 #, no-c-format msgid "JDBC: Fixed JTS handling for multi-dimensional geometries (thanks to Thomas Marti for hint and partial patch). Additionally, now JavaDoc is compiled and packaged. Fixed classpath problems with GCJ. Fixed pgjdbc 8.2 compatibility, losing support for jdk 1.3 and older." msgstr "" #. Tag: title -#: release_notes.xml:1105 +#: release_notes.xml:1200 #, no-c-format msgid "Release 1.2.0" msgstr "" #. Tag: para -#: release_notes.xml:1107 +#: release_notes.xml:1202 #, no-c-format msgid "Release date: 2006/12/08" msgstr "" #. Tag: para -#: release_notes.xml:1109 +#: release_notes.xml:1204 #, no-c-format msgid "This release provides type definitions along with serialization/deserialization capabilities for SQL-MM defined curved geometries, as well as performance enhancements." msgstr "" #. Tag: para -#: release_notes.xml:1116 +#: release_notes.xml:1211 #, no-c-format msgid "Added curved geometry type support for serialization/deserialization" msgstr "" #. Tag: para -#: release_notes.xml:1119 +#: release_notes.xml:1214 #, no-c-format msgid "Added point-in-polygon shortcircuit to the Contains and Within functions to improve performance for these cases." msgstr "" #. Tag: title -#: release_notes.xml:1125 +#: release_notes.xml:1220 #, no-c-format msgid "Release 1.1.6" msgstr "" #. Tag: para -#: release_notes.xml:1127 +#: release_notes.xml:1222 #, no-c-format msgid "Release date: 2006/11/02" msgstr "" #. Tag: para -#: release_notes.xml:1129 +#: release_notes.xml:1224 #, no-c-format msgid "This is a bugfix release, in particular fixing a critical error with GEOS interface in 64bit systems. Includes an updated of the SRS parameters and an improvement in reprojections (take Z in consideration). Upgrade is encouraged." msgstr "" #. Tag: title -#: release_notes.xml:1135 release_notes.xml:1186 release_notes.xml:1237 release_notes.xml:1292 release_notes.xml:1371 release_notes.xml:1437 release_notes.xml:1510 release_notes.xml:1654 release_notes.xml:1711 release_notes.xml:1774 release_notes.xml:1832 release_notes.xml:1890 release_notes.xml:1930 release_notes.xml:1982 release_notes.xml:2034 release_notes.xml:2073 release_notes.xml:2110 release_notes.xml:2177 release_notes.xml:2274 release_notes.xml:2328 +#: release_notes.xml:1230 release_notes.xml:1281 release_notes.xml:1332 release_notes.xml:1387 release_notes.xml:1466 release_notes.xml:1532 release_notes.xml:1605 release_notes.xml:1749 release_notes.xml:1806 release_notes.xml:1869 release_notes.xml:1927 release_notes.xml:1985 release_notes.xml:2025 release_notes.xml:2077 release_notes.xml:2129 release_notes.xml:2168 release_notes.xml:2205 release_notes.xml:2272 release_notes.xml:2369 release_notes.xml:2423 #, no-c-format msgid "Upgrading" msgstr "" #. Tag: para -#: release_notes.xml:1137 release_notes.xml:1188 release_notes.xml:1239 release_notes.xml:1294 release_notes.xml:1373 release_notes.xml:1439 +#: release_notes.xml:1232 release_notes.xml:1283 release_notes.xml:1334 release_notes.xml:1389 release_notes.xml:1468 release_notes.xml:1534 #, no-c-format msgid "If you are upgrading from release 1.0.3 or later follow the soft upgrade procedure." msgstr "" #. Tag: para -#: release_notes.xml:1140 release_notes.xml:1191 release_notes.xml:1242 release_notes.xml:1297 release_notes.xml:1376 release_notes.xml:1442 release_notes.xml:1518 release_notes.xml:1659 release_notes.xml:1716 release_notes.xml:1779 +#: release_notes.xml:1235 release_notes.xml:1286 release_notes.xml:1337 release_notes.xml:1392 release_notes.xml:1471 release_notes.xml:1537 release_notes.xml:1613 release_notes.xml:1754 release_notes.xml:1811 release_notes.xml:1874 #, no-c-format msgid "If you are upgrading from a release between 1.0.0RC6 and 1.0.2 (inclusive) and really want a live upgrade read the upgrade section of the 1.0.3 release notes chapter." msgstr "" #. Tag: para -#: release_notes.xml:1145 release_notes.xml:1196 release_notes.xml:1247 release_notes.xml:1302 release_notes.xml:1381 release_notes.xml:1447 release_notes.xml:1523 release_notes.xml:1664 release_notes.xml:1721 release_notes.xml:1784 +#: release_notes.xml:1240 release_notes.xml:1291 release_notes.xml:1342 release_notes.xml:1397 release_notes.xml:1476 release_notes.xml:1542 release_notes.xml:1618 release_notes.xml:1759 release_notes.xml:1816 release_notes.xml:1879 #, no-c-format msgid "Upgrade from any release prior to 1.0.0RC6 requires an hard upgrade." msgstr "" #. Tag: para -#: release_notes.xml:1152 +#: release_notes.xml:1247 #, no-c-format msgid "fixed CAPI change that broke 64-bit platforms" msgstr "" #. Tag: para -#: release_notes.xml:1154 +#: release_notes.xml:1249 #, no-c-format msgid "loader/dumper: fixed regression tests and usage output" msgstr "" #. Tag: para -#: release_notes.xml:1156 +#: release_notes.xml:1251 #, no-c-format msgid "Fixed setSRID() bug in JDBC, thanks to Thomas Marti" msgstr "" #. Tag: title -#: release_notes.xml:1160 release_notes.xml:1344 release_notes.xml:1415 release_notes.xml:1629 release_notes.xml:1755 release_notes.xml:2056 release_notes.xml:2093 release_notes.xml:2145 release_notes.xml:2247 release_notes.xml:2310 +#: release_notes.xml:1255 release_notes.xml:1439 release_notes.xml:1510 release_notes.xml:1724 release_notes.xml:1850 release_notes.xml:2151 release_notes.xml:2188 release_notes.xml:2240 release_notes.xml:2342 release_notes.xml:2405 #, no-c-format msgid "Other changes" msgstr "" #. Tag: para -#: release_notes.xml:1162 +#: release_notes.xml:1257 #, no-c-format msgid "use Z ordinate in reprojections" msgstr "" #. Tag: para -#: release_notes.xml:1164 +#: release_notes.xml:1259 #, no-c-format msgid "spatial_ref_sys.sql updated to EPSG 6.11.1" msgstr "" #. Tag: para -#: release_notes.xml:1166 +#: release_notes.xml:1261 #, no-c-format msgid "Simplified Version.config infrastructure to use a single pack of version variables for everything." msgstr "" #. Tag: para -#: release_notes.xml:1169 +#: release_notes.xml:1264 #, no-c-format msgid "Include the Version.config in loader/dumper USAGE messages" msgstr "" #. Tag: para -#: release_notes.xml:1172 +#: release_notes.xml:1267 #, no-c-format msgid "Replace hand-made, fragile JDBC version parser with Properties" msgstr "" #. Tag: title -#: release_notes.xml:1178 +#: release_notes.xml:1273 #, no-c-format msgid "Release 1.1.5" msgstr "" #. Tag: para -#: release_notes.xml:1180 +#: release_notes.xml:1275 #, no-c-format msgid "Release date: 2006/10/13" msgstr "" #. Tag: para -#: release_notes.xml:1182 +#: release_notes.xml:1277 #, no-c-format msgid "This is an bugfix release, including a critical segfault on win32. Upgrade is encouraged." msgstr "" #. Tag: para -#: release_notes.xml:1203 +#: release_notes.xml:1298 #, no-c-format msgid "Fixed MingW link error that was causing pgsql2shp to segfault on Win32 when compiled for PostgreSQL 8.2" msgstr "" #. Tag: para -#: release_notes.xml:1206 +#: release_notes.xml:1301 #, no-c-format msgid "fixed nullpointer Exception in Geometry.equals() method in Java" msgstr "" #. Tag: para -#: release_notes.xml:1209 +#: release_notes.xml:1304 #, no-c-format msgid "Added EJB3Spatial.odt to fulfill the GPL requirement of distributing the \"preferred form of modification\"" msgstr "" #. Tag: para -#: release_notes.xml:1212 +#: release_notes.xml:1307 #, no-c-format msgid "Removed obsolete synchronization from JDBC Jts code." msgstr "" #. Tag: para -#: release_notes.xml:1214 +#: release_notes.xml:1309 #, no-c-format msgid "Updated heavily outdated README files for shp2pgsql/pgsql2shp by merging them with the manpages." msgstr "" #. Tag: para -#: release_notes.xml:1217 +#: release_notes.xml:1312 #, no-c-format msgid "Fixed version tag in jdbc code that still said \"1.1.3\" in the \"1.1.4\" release." msgstr "" #. Tag: para -#: release_notes.xml:1224 +#: release_notes.xml:1319 #, no-c-format msgid "Added -S option for non-multi geometries to shp2pgsql" msgstr "" #. Tag: title -#: release_notes.xml:1229 +#: release_notes.xml:1324 #, no-c-format msgid "Release 1.1.4" msgstr "" #. Tag: para -#: release_notes.xml:1231 +#: release_notes.xml:1326 #, no-c-format msgid "Release date: 2006/09/27" msgstr "" #. Tag: para -#: release_notes.xml:1233 +#: release_notes.xml:1328 #, no-c-format msgid "This is an bugfix release including some improvements in the Java interface. Upgrade is encouraged." msgstr "" #. Tag: para -#: release_notes.xml:1254 +#: release_notes.xml:1349 #, no-c-format msgid "Fixed support for PostgreSQL 8.2" msgstr "" #. Tag: para -#: release_notes.xml:1256 +#: release_notes.xml:1351 #, no-c-format msgid "Fixed bug in collect() function discarding SRID of input" msgstr "" #. Tag: para -#: release_notes.xml:1258 +#: release_notes.xml:1353 #, no-c-format msgid "Added SRID match check in MakeBox2d and MakeBox3d" msgstr "" #. Tag: para -#: release_notes.xml:1260 +#: release_notes.xml:1355 #, no-c-format msgid "Fixed regress tests to pass with GEOS-3.0.0" msgstr "" #. Tag: para -#: release_notes.xml:1262 +#: release_notes.xml:1357 #, no-c-format msgid "Improved pgsql2shp run concurrency." msgstr "" #. Tag: title -#: release_notes.xml:1266 +#: release_notes.xml:1361 #, no-c-format msgid "Java changes" msgstr "" #. Tag: para -#: release_notes.xml:1268 +#: release_notes.xml:1363 #, no-c-format msgid "reworked JTS support to reflect new upstream JTS developers' attitude to SRID handling. Simplifies code and drops build depend on GNU trove." msgstr "" #. Tag: para -#: release_notes.xml:1272 +#: release_notes.xml:1367 #, no-c-format msgid "Added EJB2 support generously donated by the \"Geodetix s.r.l. Company\" http://www.geodetix.it/" msgstr "" #. Tag: para -#: release_notes.xml:1275 +#: release_notes.xml:1370 #, no-c-format msgid "Added EJB3 tutorial / examples donated by Norman Barker <nbarker@ittvis.com>" msgstr "" #. Tag: para -#: release_notes.xml:1278 +#: release_notes.xml:1373 #, no-c-format msgid "Reorganized java directory layout a little." msgstr "" #. Tag: title -#: release_notes.xml:1283 +#: release_notes.xml:1378 #, no-c-format msgid "Release 1.1.3" msgstr "" #. Tag: para -#: release_notes.xml:1285 +#: release_notes.xml:1380 #, no-c-format msgid "Release date: 2006/06/30" msgstr "" #. Tag: para -#: release_notes.xml:1287 +#: release_notes.xml:1382 #, no-c-format msgid "This is an bugfix release including also some new functionalities (most notably long transaction support) and portability enhancements. Upgrade is encouraged." msgstr "" #. Tag: title -#: release_notes.xml:1307 +#: release_notes.xml:1402 #, no-c-format msgid "Bug fixes / correctness" msgstr "" #. Tag: para -#: release_notes.xml:1309 +#: release_notes.xml:1404 #, no-c-format msgid "BUGFIX in distance(poly,poly) giving wrong results." msgstr "" #. Tag: para -#: release_notes.xml:1311 +#: release_notes.xml:1406 #, no-c-format msgid "BUGFIX in pgsql2shp successful return code." msgstr "" #. Tag: para -#: release_notes.xml:1313 +#: release_notes.xml:1408 #, no-c-format msgid "BUGFIX in shp2pgsql handling of MultiLine WKT." msgstr "" #. Tag: para -#: release_notes.xml:1315 +#: release_notes.xml:1410 #, no-c-format msgid "BUGFIX in affine() failing to update bounding box." msgstr "" #. Tag: para -#: release_notes.xml:1317 +#: release_notes.xml:1412 #, no-c-format msgid "WKT parser: forbidden construction of multigeometries with EMPTY elements (still supported for GEOMETRYCOLLECTION)." msgstr "" #. Tag: title -#: release_notes.xml:1322 release_notes.xml:1398 release_notes.xml:1471 +#: release_notes.xml:1417 release_notes.xml:1493 release_notes.xml:1566 #, no-c-format msgid "New functionalities" msgstr "" #. Tag: para -#: release_notes.xml:1324 +#: release_notes.xml:1419 #, no-c-format msgid "NEW Long Transactions support." msgstr "" #. Tag: para -#: release_notes.xml:1326 +#: release_notes.xml:1421 #, no-c-format msgid "NEW DumpRings() function." msgstr "" #. Tag: para -#: release_notes.xml:1328 +#: release_notes.xml:1423 #, no-c-format msgid "NEW AsHEXEWKB(geom, XDR|NDR) function." msgstr "" #. Tag: title -#: release_notes.xml:1332 release_notes.xml:2223 +#: release_notes.xml:1427 release_notes.xml:2318 #, no-c-format msgid "JDBC changes" msgstr "" #. Tag: para -#: release_notes.xml:1334 +#: release_notes.xml:1429 #, no-c-format msgid "Improved regression tests: MultiPoint and scientific ordinates" msgstr "" #. Tag: para -#: release_notes.xml:1337 +#: release_notes.xml:1432 #, no-c-format msgid "Fixed some minor bugs in jdbc code" msgstr "" #. Tag: para -#: release_notes.xml:1339 +#: release_notes.xml:1434 #, no-c-format msgid "Added proper accessor functions for all fields in preparation of making those fields private later" msgstr "" #. Tag: para -#: release_notes.xml:1346 +#: release_notes.xml:1441 #, no-c-format msgid "NEW regress test support for loader/dumper." msgstr "" #. Tag: para -#: release_notes.xml:1348 +#: release_notes.xml:1443 #, no-c-format msgid "Added --with-proj-libdir and --with-geos-libdir configure switches." msgstr "" #. Tag: para -#: release_notes.xml:1351 +#: release_notes.xml:1446 #, no-c-format msgid "Support for build Tru64 build." msgstr "" #. Tag: para -#: release_notes.xml:1353 +#: release_notes.xml:1448 #, no-c-format msgid "Use Jade for generating documentation." msgstr "" #. Tag: para -#: release_notes.xml:1355 +#: release_notes.xml:1450 #, no-c-format msgid "Don't link pgsql2shp to more libs then required." msgstr "" #. Tag: para -#: release_notes.xml:1357 +#: release_notes.xml:1452 #, no-c-format msgid "Initial support for PostgreSQL 8.2." msgstr "" #. Tag: title -#: release_notes.xml:1362 +#: release_notes.xml:1457 #, no-c-format msgid "Release 1.1.2" msgstr "" #. Tag: para -#: release_notes.xml:1364 +#: release_notes.xml:1459 #, no-c-format msgid "Release date: 2006/03/30" msgstr "" #. Tag: para -#: release_notes.xml:1366 +#: release_notes.xml:1461 #, no-c-format msgid "This is an bugfix release including some new functions and portability enhancements. Upgrade is encouraged." msgstr "" #. Tag: para -#: release_notes.xml:1388 +#: release_notes.xml:1483 #, no-c-format msgid "BUGFIX in SnapToGrid() computation of output bounding box" msgstr "" #. Tag: para -#: release_notes.xml:1390 +#: release_notes.xml:1485 #, no-c-format msgid "BUGFIX in EnforceRHR()" msgstr "" #. Tag: para -#: release_notes.xml:1392 +#: release_notes.xml:1487 #, no-c-format msgid "jdbc2 SRID handling fixes in JTS code" msgstr "" #. Tag: para -#: release_notes.xml:1394 +#: release_notes.xml:1489 #, no-c-format msgid "Fixed support for 64bit archs" msgstr "" #. Tag: para -#: release_notes.xml:1400 +#: release_notes.xml:1495 #, no-c-format msgid "Regress tests can now be run *before* postgis installation" msgstr "" #. Tag: para -#: release_notes.xml:1403 +#: release_notes.xml:1498 #, no-c-format msgid "New affine() matrix transformation functions" msgstr "" #. Tag: para -#: release_notes.xml:1405 +#: release_notes.xml:1500 #, no-c-format msgid "New rotate{,X,Y,Z}() function" msgstr "" #. Tag: para -#: release_notes.xml:1407 +#: release_notes.xml:1502 #, no-c-format msgid "Old translating and scaling functions now use affine() internally" msgstr "" #. Tag: para -#: release_notes.xml:1410 +#: release_notes.xml:1505 #, no-c-format msgid "Embedded access control in estimated_extent() for builds against pgsql >= 8.0.0" msgstr "" #. Tag: para -#: release_notes.xml:1417 +#: release_notes.xml:1512 #, no-c-format msgid "More portable ./configure script" msgstr "" #. Tag: para -#: release_notes.xml:1419 +#: release_notes.xml:1514 #, no-c-format msgid "Changed ./run_test script to have more sane default behaviour" msgstr "" #. Tag: title -#: release_notes.xml:1425 +#: release_notes.xml:1520 #, no-c-format msgid "Release 1.1.1" msgstr "" #. Tag: para -#: release_notes.xml:1427 +#: release_notes.xml:1522 #, no-c-format msgid "Release date: 2006/01/23" msgstr "" #. Tag: para -#: release_notes.xml:1429 +#: release_notes.xml:1524 #, no-c-format msgid "This is an important Bugfix release, upgrade is highly recommended. Previous version contained a bug in postgis_restore.pl preventing hard upgrade procedure to complete and a bug in GEOS-2.2+ connector preventing GeometryCollection objects to be used in topological operations." msgstr "" #. Tag: para -#: release_notes.xml:1454 +#: release_notes.xml:1549 #, no-c-format msgid "Fixed a premature exit in postgis_restore.pl" msgstr "" #. Tag: para -#: release_notes.xml:1456 +#: release_notes.xml:1551 #, no-c-format msgid "BUGFIX in geometrycollection handling of GEOS-CAPI connector" msgstr "" #. Tag: para -#: release_notes.xml:1459 +#: release_notes.xml:1554 #, no-c-format msgid "Solaris 2.7 and MingW support improvements" msgstr "" #. Tag: para -#: release_notes.xml:1461 +#: release_notes.xml:1556 #, no-c-format msgid "BUGFIX in line_locate_point()" msgstr "" #. Tag: para -#: release_notes.xml:1463 +#: release_notes.xml:1558 #, no-c-format msgid "Fixed handling of postgresql paths" msgstr "" #. Tag: para -#: release_notes.xml:1465 +#: release_notes.xml:1560 #, no-c-format msgid "BUGFIX in line_substring()" msgstr "" #. Tag: para -#: release_notes.xml:1467 +#: release_notes.xml:1562 #, no-c-format msgid "Added support for localized cluster in regress tester" msgstr "" #. Tag: para -#: release_notes.xml:1473 +#: release_notes.xml:1568 #, no-c-format msgid "New Z and M interpolation in line_substring()" msgstr "" #. Tag: para -#: release_notes.xml:1475 +#: release_notes.xml:1570 #, no-c-format msgid "New Z and M interpolation in line_interpolate_point()" msgstr "" #. Tag: para -#: release_notes.xml:1477 +#: release_notes.xml:1572 #, no-c-format msgid "added NumInteriorRing() alias due to OpenGIS ambiguity" msgstr "" #. Tag: title -#: release_notes.xml:1482 +#: release_notes.xml:1577 #, no-c-format msgid "Release 1.1.0" msgstr "" #. Tag: para -#: release_notes.xml:1484 +#: release_notes.xml:1579 #, no-c-format msgid "Release date: 2005/12/21" msgstr "" #. Tag: para -#: release_notes.xml:1486 +#: release_notes.xml:1581 #, no-c-format msgid "This is a Minor release, containing many improvements and new things. Most notably: build procedure greatly simplified; transform() performance drastically improved; more stable GEOS connectivity (CAPI support); lots of new functions; draft topology support." msgstr "" #. Tag: para -#: release_notes.xml:1491 +#: release_notes.xml:1586 #, no-c-format msgid "It is highly recommended that you upgrade to GEOS-2.2.x before installing PostGIS, this will ensure future GEOS upgrades won't require a rebuild of the PostGIS library." msgstr "" #. Tag: title -#: release_notes.xml:1496 +#: release_notes.xml:1591 #, no-c-format msgid "Credits" msgstr "" #. Tag: para -#: release_notes.xml:1498 +#: release_notes.xml:1593 #, no-c-format msgid "This release includes code from Mark Cave Ayland for caching of proj4 objects. Markus Schaber added many improvements in his JDBC2 code. Alex Bodnaru helped with PostgreSQL source dependency relief and provided Debian specfiles. Michael Fuhr tested new things on Solaris arch. David Techer and Gerald Fenoy helped testing GEOS C-API connector. Hartmut Tschauner provided code for the azimuth() function. Devrim GUNDUZ provided RPM specfiles. Carl Anderson helped with the new area building functions. See the credits section for more names." msgstr "" #. Tag: para -#: release_notes.xml:1512 +#: release_notes.xml:1607 #, no-c-format msgid "If you are upgrading from release 1.0.3 or later you DO NOT need a dump/reload. Simply sourcing the new lwpostgis_upgrade.sql script in all your existing databases will work. See the soft upgrade chapter for more information." msgstr "" #. Tag: title -#: release_notes.xml:1528 +#: release_notes.xml:1623 #, no-c-format msgid "New functions" msgstr "" #. Tag: para -#: release_notes.xml:1530 +#: release_notes.xml:1625 #, no-c-format msgid "scale() and transscale() companion methods to translate()" msgstr "" #. Tag: para -#: release_notes.xml:1532 +#: release_notes.xml:1627 #, no-c-format msgid "line_substring()" msgstr "" #. Tag: para -#: release_notes.xml:1534 +#: release_notes.xml:1629 #, no-c-format msgid "line_locate_point()" msgstr "" #. Tag: para -#: release_notes.xml:1536 +#: release_notes.xml:1631 #, no-c-format msgid "M(point)" msgstr "" #. Tag: para -#: release_notes.xml:1538 +#: release_notes.xml:1633 #, no-c-format msgid "LineMerge(geometry)" msgstr "" #. Tag: para -#: release_notes.xml:1540 +#: release_notes.xml:1635 #, no-c-format msgid "shift_longitude(geometry)" msgstr "" #. Tag: para -#: release_notes.xml:1542 +#: release_notes.xml:1637 #, no-c-format msgid "azimuth(geometry)" msgstr "" #. Tag: para -#: release_notes.xml:1544 +#: release_notes.xml:1639 #, no-c-format msgid "locate_along_measure(geometry, float8)" msgstr "" #. Tag: para -#: release_notes.xml:1546 +#: release_notes.xml:1641 #, no-c-format msgid "locate_between_measures(geometry, float8, float8)" msgstr "" #. Tag: para -#: release_notes.xml:1548 +#: release_notes.xml:1643 #, no-c-format msgid "SnapToGrid by point offset (up to 4d support)" msgstr "" #. Tag: para -#: release_notes.xml:1550 +#: release_notes.xml:1645 #, no-c-format msgid "BuildArea(any_geometry)" msgstr "" #. Tag: para -#: release_notes.xml:1552 +#: release_notes.xml:1647 #, no-c-format msgid "OGC BdPolyFromText(linestring_wkt, srid)" msgstr "" #. Tag: para -#: release_notes.xml:1554 +#: release_notes.xml:1649 #, no-c-format msgid "OGC BdMPolyFromText(linestring_wkt, srid)" msgstr "" #. Tag: para -#: release_notes.xml:1556 +#: release_notes.xml:1651 #, no-c-format msgid "RemovePoint(linestring, offset)" msgstr "" #. Tag: para -#: release_notes.xml:1558 +#: release_notes.xml:1653 #, no-c-format msgid "ReplacePoint(linestring, offset, point)" msgstr "" #. Tag: para -#: release_notes.xml:1564 +#: release_notes.xml:1659 #, no-c-format msgid "Fixed memory leak in polygonize()" msgstr "" #. Tag: para -#: release_notes.xml:1566 +#: release_notes.xml:1661 #, no-c-format msgid "Fixed bug in lwgeom_as_anytype cast functions" msgstr "" #. Tag: para -#: release_notes.xml:1568 +#: release_notes.xml:1663 #, no-c-format msgid "Fixed USE_GEOS, USE_PROJ and USE_STATS elements of postgis_version() output to always reflect library state." msgstr "" #. Tag: title -#: release_notes.xml:1573 +#: release_notes.xml:1668 #, no-c-format msgid "Function semantic changes" msgstr "" #. Tag: para -#: release_notes.xml:1575 +#: release_notes.xml:1670 #, no-c-format msgid "SnapToGrid doesn't discard higher dimensions" msgstr "" #. Tag: para -#: release_notes.xml:1577 +#: release_notes.xml:1672 #, no-c-format msgid "Changed Z() function to return NULL if requested dimension is not available" msgstr "" #. Tag: title -#: release_notes.xml:1582 +#: release_notes.xml:1677 #, no-c-format msgid "Performance improvements" msgstr "" #. Tag: para -#: release_notes.xml:1584 +#: release_notes.xml:1679 #, no-c-format msgid "Much faster transform() function, caching proj4 objects" msgstr "" #. Tag: para -#: release_notes.xml:1586 +#: release_notes.xml:1681 #, no-c-format msgid "Removed automatic call to fix_geometry_columns() in AddGeometryColumns() and update_geometry_stats()" msgstr "" #. Tag: title -#: release_notes.xml:1591 +#: release_notes.xml:1686 #, no-c-format msgid "JDBC2 works" msgstr "" #. Tag: para -#: release_notes.xml:1593 +#: release_notes.xml:1688 #, no-c-format msgid "Makefile improvements" msgstr "" #. Tag: para -#: release_notes.xml:1595 release_notes.xml:1631 +#: release_notes.xml:1690 release_notes.xml:1726 #, no-c-format msgid "JTS support improvements" msgstr "" #. Tag: para -#: release_notes.xml:1597 +#: release_notes.xml:1692 #, no-c-format msgid "Improved regression test system" msgstr "" #. Tag: para -#: release_notes.xml:1599 +#: release_notes.xml:1694 #, no-c-format msgid "Basic consistency check method for geometry collections" msgstr "" #. Tag: para -#: release_notes.xml:1601 +#: release_notes.xml:1696 #, no-c-format msgid "Support for (Hex)(E)wkb" msgstr "" #. Tag: para -#: release_notes.xml:1603 +#: release_notes.xml:1698 #, no-c-format msgid "Autoprobing DriverWrapper for HexWKB / EWKT switching" msgstr "" #. Tag: para -#: release_notes.xml:1605 +#: release_notes.xml:1700 #, no-c-format msgid "fix compile problems in ValueSetter for ancient jdk releases." msgstr "" #. Tag: para -#: release_notes.xml:1608 +#: release_notes.xml:1703 #, no-c-format msgid "fix EWKT constructors to accept SRID=4711; representation" msgstr "" #. Tag: para -#: release_notes.xml:1610 +#: release_notes.xml:1705 #, no-c-format msgid "added preliminary read-only support for java2d geometries" msgstr "" #. Tag: title -#: release_notes.xml:1614 +#: release_notes.xml:1709 #, no-c-format msgid "Other new things" msgstr "" #. Tag: para -#: release_notes.xml:1616 +#: release_notes.xml:1711 #, no-c-format msgid "Full autoconf-based configuration, with PostgreSQL source dependency relief" msgstr "" #. Tag: para -#: release_notes.xml:1619 +#: release_notes.xml:1714 #, no-c-format msgid "GEOS C-API support (2.2.0 and higher)" msgstr "" #. Tag: para -#: release_notes.xml:1621 +#: release_notes.xml:1716 #, no-c-format msgid "Initial support for topology modelling" msgstr "" #. Tag: para -#: release_notes.xml:1623 +#: release_notes.xml:1718 #, no-c-format msgid "Debian and RPM specfiles" msgstr "" #. Tag: para -#: release_notes.xml:1625 +#: release_notes.xml:1720 #, no-c-format msgid "New lwpostgis_upgrade.sql script" msgstr "" #. Tag: para -#: release_notes.xml:1633 +#: release_notes.xml:1728 #, no-c-format msgid "Stricter mapping between DBF and SQL integer and string attributes" msgstr "" #. Tag: para -#: release_notes.xml:1636 +#: release_notes.xml:1731 #, no-c-format msgid "Wider and cleaner regression test suite" msgstr "" #. Tag: para -#: release_notes.xml:1638 +#: release_notes.xml:1733 #, no-c-format msgid "old jdbc code removed from release" msgstr "" #. Tag: para -#: release_notes.xml:1640 +#: release_notes.xml:1735 #, no-c-format msgid "obsoleted direct use of postgis_proc_upgrade.pl" msgstr "" #. Tag: para -#: release_notes.xml:1642 +#: release_notes.xml:1737 #, no-c-format msgid "scripts version unified with release version" msgstr "" #. Tag: title -#: release_notes.xml:1647 +#: release_notes.xml:1742 #, no-c-format msgid "Release 1.0.6" msgstr "" #. Tag: para -#: release_notes.xml:1649 +#: release_notes.xml:1744 #, no-c-format msgid "Release date: 2005/12/06" msgstr "" #. Tag: para -#: release_notes.xml:1651 release_notes.xml:1887 +#: release_notes.xml:1746 release_notes.xml:1982 #, no-c-format msgid "Contains a few bug fixes and improvements." msgstr "" #. Tag: para -#: release_notes.xml:1656 release_notes.xml:1713 +#: release_notes.xml:1751 release_notes.xml:1808 #, no-c-format msgid "If you are upgrading from release 1.0.3 or later you DO NOT need a dump/reload." msgstr "" #. Tag: para -#: release_notes.xml:1671 +#: release_notes.xml:1766 #, no-c-format msgid "Fixed palloc(0) call in collection deserializer (only gives problem with --enable-cassert)" msgstr "" #. Tag: para -#: release_notes.xml:1674 +#: release_notes.xml:1769 #, no-c-format msgid "Fixed bbox cache handling bugs" msgstr "" #. Tag: para -#: release_notes.xml:1676 +#: release_notes.xml:1771 #, no-c-format msgid "Fixed geom_accum(NULL, NULL) segfault" msgstr "" #. Tag: para -#: release_notes.xml:1678 +#: release_notes.xml:1773 #, no-c-format msgid "Fixed segfault in addPoint()" msgstr "" #. Tag: para -#: release_notes.xml:1680 +#: release_notes.xml:1775 #, no-c-format msgid "Fixed short-allocation in lwcollection_clone()" msgstr "" #. Tag: para -#: release_notes.xml:1682 +#: release_notes.xml:1777 #, no-c-format msgid "Fixed bug in segmentize()" msgstr "" #. Tag: para -#: release_notes.xml:1684 +#: release_notes.xml:1779 #, no-c-format msgid "Fixed bbox computation of SnapToGrid output" msgstr "" #. Tag: title -#: release_notes.xml:1688 release_notes.xml:1806 release_notes.xml:1868 release_notes.xml:1914 +#: release_notes.xml:1783 release_notes.xml:1901 release_notes.xml:1963 release_notes.xml:2009 #, no-c-format msgid "Improvements" msgstr "" #. Tag: para -#: release_notes.xml:1690 +#: release_notes.xml:1785 #, no-c-format msgid "Initial support for postgresql 8.2" msgstr "" #. Tag: para -#: release_notes.xml:1692 +#: release_notes.xml:1787 #, no-c-format msgid "Added missing SRID mismatch checks in GEOS ops" msgstr "" #. Tag: title -#: release_notes.xml:1697 +#: release_notes.xml:1792 #, no-c-format msgid "Release 1.0.5" msgstr "" #. Tag: para -#: release_notes.xml:1699 +#: release_notes.xml:1794 #, no-c-format msgid "Release date: 2005/11/25" msgstr "" #. Tag: para -#: release_notes.xml:1701 +#: release_notes.xml:1796 #, no-c-format msgid "Contains memory-alignment fixes in the library, a segfault fix in loader's handling of UTF8 attributes and a few improvements and cleanups." msgstr "" #. Tag: para -#: release_notes.xml:1706 +#: release_notes.xml:1801 #, no-c-format msgid "Return code of shp2pgsql changed from previous releases to conform to unix standards (return 0 on success)." msgstr "" #. Tag: title -#: release_notes.xml:1726 release_notes.xml:1941 release_notes.xml:1993 release_notes.xml:2042 release_notes.xml:2084 release_notes.xml:2118 release_notes.xml:2185 release_notes.xml:2282 +#: release_notes.xml:1821 release_notes.xml:2036 release_notes.xml:2088 release_notes.xml:2137 release_notes.xml:2179 release_notes.xml:2213 release_notes.xml:2280 release_notes.xml:2377 #, no-c-format msgid "Library changes" msgstr "" #. Tag: para -#: release_notes.xml:1728 +#: release_notes.xml:1823 #, no-c-format msgid "Fixed memory alignment problems" msgstr "" #. Tag: para -#: release_notes.xml:1730 +#: release_notes.xml:1825 #, no-c-format msgid "Fixed computation of null values fraction in analyzer" msgstr "" #. Tag: para -#: release_notes.xml:1732 +#: release_notes.xml:1827 #, no-c-format msgid "Fixed a small bug in the getPoint4d_p() low-level function" msgstr "" #. Tag: para -#: release_notes.xml:1735 +#: release_notes.xml:1830 #, no-c-format msgid "Speedup of serializer functions" msgstr "" #. Tag: para -#: release_notes.xml:1737 +#: release_notes.xml:1832 #, no-c-format msgid "Fixed a bug in force_3dm(), force_3dz() and force_4d()" msgstr "" #. Tag: title -#: release_notes.xml:1741 +#: release_notes.xml:1836 #, no-c-format msgid "Loader changes" msgstr "" #. Tag: para -#: release_notes.xml:1743 +#: release_notes.xml:1838 #, no-c-format msgid "Fixed return code of shp2pgsql" msgstr "" #. Tag: para -#: release_notes.xml:1745 +#: release_notes.xml:1840 #, no-c-format msgid "Fixed back-compatibility issue in loader (load of null shapefiles)" msgstr "" #. Tag: para -#: release_notes.xml:1748 +#: release_notes.xml:1843 #, no-c-format msgid "Fixed handling of trailing dots in dbf numerical attributes" msgstr "" #. Tag: para -#: release_notes.xml:1751 +#: release_notes.xml:1846 #, no-c-format msgid "Segfault fix in shp2pgsql (utf8 encoding)" msgstr "" #. Tag: para -#: release_notes.xml:1757 +#: release_notes.xml:1852 #, no-c-format msgid "Schema aware postgis_proc_upgrade.pl, support for pgsql 7.2+" msgstr "" #. Tag: para -#: release_notes.xml:1760 +#: release_notes.xml:1855 #, no-c-format msgid "New \"Reporting Bugs\" chapter in manual" msgstr "" #. Tag: title -#: release_notes.xml:1765 +#: release_notes.xml:1860 #, no-c-format msgid "Release 1.0.4" msgstr "" #. Tag: para -#: release_notes.xml:1767 +#: release_notes.xml:1862 #, no-c-format msgid "Release date: 2005/09/09" msgstr "" #. Tag: para -#: release_notes.xml:1769 +#: release_notes.xml:1864 #, no-c-format msgid "Contains important bug fixes and a few improvements. In particular, it fixes a memory leak preventing successful build of GiST indexes for large spatial tables." msgstr "" #. Tag: para -#: release_notes.xml:1776 +#: release_notes.xml:1871 #, no-c-format msgid "If you are upgrading from release 1.0.3 you DO NOT need a dump/reload." msgstr "" #. Tag: para -#: release_notes.xml:1791 +#: release_notes.xml:1886 #, no-c-format msgid "Memory leak plugged in GiST indexing" msgstr "" #. Tag: para -#: release_notes.xml:1793 +#: release_notes.xml:1888 #, no-c-format msgid "Segfault fix in transform() handling of proj4 errors" msgstr "" #. Tag: para -#: release_notes.xml:1795 +#: release_notes.xml:1890 #, no-c-format msgid "Fixed some proj4 texts in spatial_ref_sys (missing +proj)" msgstr "" #. Tag: para -#: release_notes.xml:1797 +#: release_notes.xml:1892 #, no-c-format msgid "Loader: fixed string functions usage, reworked NULL objects check, fixed segfault on MULTILINESTRING input." msgstr "" #. Tag: para -#: release_notes.xml:1800 +#: release_notes.xml:1895 #, no-c-format msgid "Fixed bug in MakeLine dimension handling" msgstr "" #. Tag: para -#: release_notes.xml:1802 +#: release_notes.xml:1897 #, no-c-format msgid "Fixed bug in translate() corrupting output bounding box" msgstr "" #. Tag: para -#: release_notes.xml:1808 +#: release_notes.xml:1903 #, no-c-format msgid "Documentation improvements" msgstr "" #. Tag: para -#: release_notes.xml:1810 +#: release_notes.xml:1905 #, no-c-format msgid "More robust selectivity estimator" msgstr "" #. Tag: para -#: release_notes.xml:1812 +#: release_notes.xml:1907 #, no-c-format msgid "Minor speedup in distance()" msgstr "" #. Tag: para -#: release_notes.xml:1814 +#: release_notes.xml:1909 #, no-c-format msgid "Minor cleanups" msgstr "" #. Tag: para -#: release_notes.xml:1816 +#: release_notes.xml:1911 #, no-c-format msgid "GiST indexing cleanup" msgstr "" #. Tag: para -#: release_notes.xml:1818 +#: release_notes.xml:1913 #, no-c-format msgid "Looser syntax acceptance in box3d parser" msgstr "" #. Tag: title -#: release_notes.xml:1823 +#: release_notes.xml:1918 #, no-c-format msgid "Release 1.0.3" msgstr "" #. Tag: para -#: release_notes.xml:1825 +#: release_notes.xml:1920 #, no-c-format msgid "Release date: 2005/08/08" msgstr "" #. Tag: para -#: release_notes.xml:1827 +#: release_notes.xml:1922 #, no-c-format msgid "Contains some bug fixes - including a severe one affecting correctness of stored geometries - and a few improvements." msgstr "" #. Tag: para -#: release_notes.xml:1834 +#: release_notes.xml:1929 #, no-c-format msgid "Due to a bug in a bounding box computation routine, the upgrade procedure requires special attention, as bounding boxes cached in the database could be incorrect." msgstr "" #. Tag: para -#: release_notes.xml:1838 +#: release_notes.xml:1933 #, no-c-format msgid "An hard upgrade procedure (dump/reload) will force recomputation of all bounding boxes (not included in dumps). This is required if upgrading from releases prior to 1.0.0RC6." msgstr "" #. Tag: para -#: release_notes.xml:1843 +#: release_notes.xml:1938 #, no-c-format msgid "If you are upgrading from versions 1.0.0RC6 or up, this release includes a perl script (utils/rebuild_bbox_caches.pl) to force recomputation of geometries' bounding boxes and invoke all operations required to propagate eventual changes in them (geometry statistics update, reindexing). Invoke the script after a make install (run with no args for syntax help). Optionally run utils/postgis_proc_upgrade.pl to refresh postgis procedures and functions signatures (see Soft upgrade)." msgstr "" #. Tag: para -#: release_notes.xml:1856 +#: release_notes.xml:1951 #, no-c-format msgid "Severe bugfix in lwgeom's 2d bounding box computation" msgstr "" #. Tag: para -#: release_notes.xml:1858 +#: release_notes.xml:1953 #, no-c-format msgid "Bugfix in WKT (-w) POINT handling in loader" msgstr "" #. Tag: para -#: release_notes.xml:1860 +#: release_notes.xml:1955 #, no-c-format msgid "Bugfix in dumper on 64bit machines" msgstr "" #. Tag: para -#: release_notes.xml:1862 +#: release_notes.xml:1957 #, no-c-format msgid "Bugfix in dumper handling of user-defined queries" msgstr "" #. Tag: para -#: release_notes.xml:1864 +#: release_notes.xml:1959 #, no-c-format msgid "Bugfix in create_undef.pl script" msgstr "" #. Tag: para -#: release_notes.xml:1870 +#: release_notes.xml:1965 #, no-c-format msgid "Small performance improvement in canonical input function" msgstr "" #. Tag: para -#: release_notes.xml:1872 +#: release_notes.xml:1967 #, no-c-format msgid "Minor cleanups in loader" msgstr "" #. Tag: para -#: release_notes.xml:1874 +#: release_notes.xml:1969 #, no-c-format msgid "Support for multibyte field names in loader" msgstr "" #. Tag: para -#: release_notes.xml:1876 +#: release_notes.xml:1971 #, no-c-format msgid "Improvement in the postgis_restore.pl script" msgstr "" #. Tag: para -#: release_notes.xml:1878 +#: release_notes.xml:1973 #, no-c-format msgid "New rebuild_bbox_caches.pl util script" msgstr "" #. Tag: title -#: release_notes.xml:1883 +#: release_notes.xml:1978 #, no-c-format msgid "Release 1.0.2" msgstr "" #. Tag: para -#: release_notes.xml:1885 +#: release_notes.xml:1980 #, no-c-format msgid "Release date: 2005/07/04" msgstr "" #. Tag: para -#: release_notes.xml:1892 release_notes.xml:1932 +#: release_notes.xml:1987 release_notes.xml:2027 #, no-c-format msgid "If you are upgrading from release 1.0.0RC6 or up you DO NOT need a dump/reload." msgstr "" #. Tag: para -#: release_notes.xml:1895 release_notes.xml:1935 +#: release_notes.xml:1990 release_notes.xml:2030 #, no-c-format msgid "Upgrading from older releases requires a dump/reload. See the upgrading chapter for more informations." msgstr "" #. Tag: para -#: release_notes.xml:1903 +#: release_notes.xml:1998 #, no-c-format msgid "Fault tolerant btree ops" msgstr "" #. Tag: para -#: release_notes.xml:1905 +#: release_notes.xml:2000 #, no-c-format msgid "Memory leak plugged in pg_error" msgstr "" #. Tag: para -#: release_notes.xml:1907 +#: release_notes.xml:2002 #, no-c-format msgid "Rtree index fix" msgstr "" #. Tag: para -#: release_notes.xml:1909 +#: release_notes.xml:2004 #, no-c-format msgid "Cleaner build scripts (avoided mix of CFLAGS and CXXFLAGS)" msgstr "" #. Tag: para -#: release_notes.xml:1916 +#: release_notes.xml:2011 #, no-c-format msgid "New index creation capabilities in loader (-I switch)" msgstr "" #. Tag: para -#: release_notes.xml:1918 +#: release_notes.xml:2013 #, no-c-format msgid "Initial support for postgresql 8.1dev" msgstr "" #. Tag: title -#: release_notes.xml:1923 +#: release_notes.xml:2018 #, no-c-format msgid "Release 1.0.1" msgstr "" #. Tag: para -#: release_notes.xml:1925 +#: release_notes.xml:2020 #, no-c-format msgid "Release date: 2005/05/24" msgstr "" #. Tag: para -#: release_notes.xml:1927 +#: release_notes.xml:2022 #, no-c-format msgid "Contains a few bug fixes and some improvements." msgstr "" #. Tag: para -#: release_notes.xml:1943 +#: release_notes.xml:2038 #, no-c-format msgid "BUGFIX in 3d computation of length_spheroid()" msgstr "" #. Tag: para -#: release_notes.xml:1945 +#: release_notes.xml:2040 #, no-c-format msgid "BUGFIX in join selectivity estimator" msgstr "" #. Tag: title -#: release_notes.xml:1949 release_notes.xml:2005 +#: release_notes.xml:2044 release_notes.xml:2100 #, no-c-format msgid "Other changes/additions" msgstr "" #. Tag: para -#: release_notes.xml:1951 +#: release_notes.xml:2046 #, no-c-format msgid "BUGFIX in shp2pgsql escape functions" msgstr "" #. Tag: para -#: release_notes.xml:1953 +#: release_notes.xml:2048 #, no-c-format msgid "better support for concurrent postgis in multiple schemas" msgstr "" #. Tag: para -#: release_notes.xml:1955 +#: release_notes.xml:2050 #, no-c-format msgid "documentation fixes" msgstr "" #. Tag: para -#: release_notes.xml:1957 +#: release_notes.xml:2052 #, no-c-format msgid "jdbc2: compile with \"-target 1.2 -source 1.2\" by default" msgstr "" #. Tag: para -#: release_notes.xml:1959 +#: release_notes.xml:2054 #, no-c-format msgid "NEW -k switch for pgsql2shp" msgstr "" #. Tag: para -#: release_notes.xml:1961 +#: release_notes.xml:2056 #, no-c-format msgid "NEW support for custom createdb options in postgis_restore.pl" msgstr "" #. Tag: para -#: release_notes.xml:1964 +#: release_notes.xml:2059 #, no-c-format msgid "BUGFIX in pgsql2shp attribute names unicity enforcement" msgstr "" #. Tag: para -#: release_notes.xml:1966 +#: release_notes.xml:2061 #, no-c-format msgid "BUGFIX in Paris projections definitions" msgstr "" #. Tag: para -#: release_notes.xml:1968 +#: release_notes.xml:2063 #, no-c-format msgid "postgis_restore.pl cleanups" msgstr "" #. Tag: title -#: release_notes.xml:1973 +#: release_notes.xml:2068 #, no-c-format msgid "Release 1.0.0" msgstr "" #. Tag: para -#: release_notes.xml:1975 +#: release_notes.xml:2070 #, no-c-format msgid "Release date: 2005/04/19" msgstr "" #. Tag: para -#: release_notes.xml:1977 +#: release_notes.xml:2072 #, no-c-format msgid "Final 1.0.0 release. Contains a few bug fixes, some improvements in the loader (most notably support for older postgis versions), and more docs." msgstr "" #. Tag: para -#: release_notes.xml:1984 +#: release_notes.xml:2079 #, no-c-format msgid "If you are upgrading from release 1.0.0RC6 you DO NOT need a dump/reload." msgstr "" #. Tag: para -#: release_notes.xml:1987 release_notes.xml:2078 +#: release_notes.xml:2082 release_notes.xml:2173 #, no-c-format msgid "Upgrading from any other precedent release requires a dump/reload. See the upgrading chapter for more informations." msgstr "" #. Tag: para -#: release_notes.xml:1995 +#: release_notes.xml:2090 #, no-c-format msgid "BUGFIX in transform() releasing random memory address" msgstr "" #. Tag: para -#: release_notes.xml:1997 +#: release_notes.xml:2092 #, no-c-format msgid "BUGFIX in force_3dm() allocating less memory then required" msgstr "" #. Tag: para -#: release_notes.xml:2000 +#: release_notes.xml:2095 #, no-c-format msgid "BUGFIX in join selectivity estimator (defaults, leaks, tuplecount, sd)" msgstr "" #. Tag: para -#: release_notes.xml:2007 +#: release_notes.xml:2102 #, no-c-format msgid "BUGFIX in shp2pgsql escape of values starting with tab or single-quote" msgstr "" #. Tag: para -#: release_notes.xml:2010 +#: release_notes.xml:2105 #, no-c-format msgid "NEW manual pages for loader/dumper" msgstr "" #. Tag: para -#: release_notes.xml:2012 +#: release_notes.xml:2107 #, no-c-format msgid "NEW shp2pgsql support for old (HWGEOM) postgis versions" msgstr "" #. Tag: para -#: release_notes.xml:2014 +#: release_notes.xml:2109 #, no-c-format msgid "NEW -p (prepare) flag for shp2pgsql" msgstr "" #. Tag: para -#: release_notes.xml:2016 +#: release_notes.xml:2111 #, no-c-format msgid "NEW manual chapter about OGC compliancy enforcement" msgstr "" #. Tag: para -#: release_notes.xml:2018 +#: release_notes.xml:2113 #, no-c-format msgid "NEW autoconf support for JTS lib" msgstr "" #. Tag: para -#: release_notes.xml:2020 +#: release_notes.xml:2115 #, no-c-format msgid "BUGFIX in estimator testers (support for LWGEOM and schema parsing)" msgstr "" #. Tag: title -#: release_notes.xml:2026 +#: release_notes.xml:2121 #, no-c-format msgid "Release 1.0.0RC6" msgstr "" #. Tag: para -#: release_notes.xml:2028 +#: release_notes.xml:2123 #, no-c-format msgid "Release date: 2005/03/30" msgstr "" #. Tag: para -#: release_notes.xml:2030 +#: release_notes.xml:2125 #, no-c-format msgid "Sixth release candidate for 1.0.0. Contains a few bug fixes and cleanups." msgstr "" #. Tag: para -#: release_notes.xml:2036 release_notes.xml:2112 release_notes.xml:2179 release_notes.xml:2276 release_notes.xml:2330 +#: release_notes.xml:2131 release_notes.xml:2207 release_notes.xml:2274 release_notes.xml:2371 release_notes.xml:2425 #, no-c-format msgid "You need a dump/reload to upgrade from precedent releases. See the upgrading chapter for more informations." msgstr "" #. Tag: para -#: release_notes.xml:2044 +#: release_notes.xml:2139 #, no-c-format msgid "BUGFIX in multi()" msgstr "" #. Tag: para -#: release_notes.xml:2046 +#: release_notes.xml:2141 #, no-c-format msgid "early return [when noop] from multi()" msgstr "" #. Tag: title -#: release_notes.xml:2050 release_notes.xml:2136 release_notes.xml:2209 release_notes.xml:2301 +#: release_notes.xml:2145 release_notes.xml:2231 release_notes.xml:2304 release_notes.xml:2396 #, no-c-format msgid "Scripts changes" msgstr "" #. Tag: para -#: release_notes.xml:2052 +#: release_notes.xml:2147 #, no-c-format msgid "dropped {x,y}{min,max}(box2d) functions" msgstr "" #. Tag: para -#: release_notes.xml:2058 +#: release_notes.xml:2153 #, no-c-format msgid "BUGFIX in postgis_restore.pl scrip" msgstr "" #. Tag: para -#: release_notes.xml:2060 +#: release_notes.xml:2155 #, no-c-format msgid "BUGFIX in dumper's 64bit support" msgstr "" #. Tag: title -#: release_notes.xml:2065 +#: release_notes.xml:2160 #, no-c-format msgid "Release 1.0.0RC5" msgstr "" #. Tag: para -#: release_notes.xml:2067 +#: release_notes.xml:2162 #, no-c-format msgid "Release date: 2005/03/25" msgstr "" #. Tag: para -#: release_notes.xml:2069 +#: release_notes.xml:2164 #, no-c-format msgid "Fifth release candidate for 1.0.0. Contains a few bug fixes and a improvements." msgstr "" #. Tag: para -#: release_notes.xml:2075 +#: release_notes.xml:2170 #, no-c-format msgid "If you are upgrading from release 1.0.0RC4 you DO NOT need a dump/reload." msgstr "" #. Tag: para -#: release_notes.xml:2086 +#: release_notes.xml:2181 #, no-c-format msgid "BUGFIX (segfaulting) in box3d computation (yes, another!)." msgstr "" #. Tag: para -#: release_notes.xml:2089 +#: release_notes.xml:2184 #, no-c-format msgid "BUGFIX (segfaulting) in estimated_extent()." msgstr "" #. Tag: para -#: release_notes.xml:2095 +#: release_notes.xml:2190 #, no-c-format msgid "Small build scripts and utilities refinements." msgstr "" #. Tag: para -#: release_notes.xml:2097 +#: release_notes.xml:2192 #, no-c-format msgid "Additional performance tips documented." msgstr "" #. Tag: title -#: release_notes.xml:2102 +#: release_notes.xml:2197 #, no-c-format msgid "Release 1.0.0RC4" msgstr "" #. Tag: para -#: release_notes.xml:2104 +#: release_notes.xml:2199 #, no-c-format msgid "Release date: 2005/03/18" msgstr "" #. Tag: para -#: release_notes.xml:2106 +#: release_notes.xml:2201 #, no-c-format msgid "Fourth release candidate for 1.0.0. Contains bug fixes and a few improvements." msgstr "" #. Tag: para -#: release_notes.xml:2120 +#: release_notes.xml:2215 #, no-c-format msgid "BUGFIX (segfaulting) in geom_accum()." msgstr "" #. Tag: para -#: release_notes.xml:2122 +#: release_notes.xml:2217 #, no-c-format msgid "BUGFIX in 64bit architectures support." msgstr "" #. Tag: para -#: release_notes.xml:2124 +#: release_notes.xml:2219 #, no-c-format msgid "BUGFIX in box3d computation function with collections." msgstr "" #. Tag: para -#: release_notes.xml:2126 +#: release_notes.xml:2221 #, no-c-format msgid "NEW subselects support in selectivity estimator." msgstr "" #. Tag: para -#: release_notes.xml:2128 +#: release_notes.xml:2223 #, no-c-format msgid "Early return from force_collection." msgstr "" #. Tag: para -#: release_notes.xml:2130 +#: release_notes.xml:2225 #, no-c-format msgid "Consistency check fix in SnapToGrid()." msgstr "" #. Tag: para -#: release_notes.xml:2132 +#: release_notes.xml:2227 #, no-c-format msgid "Box2d output changed back to 15 significant digits." msgstr "" #. Tag: para -#: release_notes.xml:2138 +#: release_notes.xml:2233 #, no-c-format msgid "NEW distance_sphere() function." msgstr "" #. Tag: para -#: release_notes.xml:2140 +#: release_notes.xml:2235 #, no-c-format msgid "Changed get_proj4_from_srid implementation to use PL/PGSQL instead of SQL." msgstr "" #. Tag: para -#: release_notes.xml:2147 +#: release_notes.xml:2242 #, no-c-format msgid "BUGFIX in loader and dumper handling of MultiLine shapes" msgstr "" #. Tag: para -#: release_notes.xml:2149 +#: release_notes.xml:2244 #, no-c-format msgid "BUGFIX in loader, skipping all but first hole of polygons." msgstr "" #. Tag: para -#: release_notes.xml:2152 +#: release_notes.xml:2247 #, no-c-format msgid "jdbc2: code cleanups, Makefile improvements" msgstr "" #. Tag: para -#: release_notes.xml:2154 +#: release_notes.xml:2249 #, no-c-format msgid "FLEX and YACC variables set *after* pgsql Makefile.global is included and only if the pgsql *stripped* version evaluates to the empty string" msgstr "" #. Tag: para -#: release_notes.xml:2158 +#: release_notes.xml:2253 #, no-c-format msgid "Added already generated parser in release" msgstr "" #. Tag: para -#: release_notes.xml:2160 +#: release_notes.xml:2255 #, no-c-format msgid "Build scripts refinements" msgstr "" #. Tag: para -#: release_notes.xml:2162 +#: release_notes.xml:2257 #, no-c-format msgid "improved version handling, central Version.config" msgstr "" #. Tag: para -#: release_notes.xml:2164 +#: release_notes.xml:2259 #, no-c-format msgid "improvements in postgis_restore.pl" msgstr "" #. Tag: title -#: release_notes.xml:2169 +#: release_notes.xml:2264 #, no-c-format msgid "Release 1.0.0RC3" msgstr "" #. Tag: para -#: release_notes.xml:2171 +#: release_notes.xml:2266 #, no-c-format msgid "Release date: 2005/02/24" msgstr "" #. Tag: para -#: release_notes.xml:2173 +#: release_notes.xml:2268 #, no-c-format msgid "Third release candidate for 1.0.0. Contains many bug fixes and improvements." msgstr "" #. Tag: para -#: release_notes.xml:2187 +#: release_notes.xml:2282 #, no-c-format msgid "BUGFIX in transform(): missing SRID, better error handling." msgstr "" #. Tag: para -#: release_notes.xml:2190 +#: release_notes.xml:2285 #, no-c-format msgid "BUGFIX in memory alignment handling" msgstr "" #. Tag: para -#: release_notes.xml:2192 +#: release_notes.xml:2287 #, no-c-format msgid "BUGFIX in force_collection() causing mapserver connector failures on simple (single) geometry types." msgstr "" #. Tag: para -#: release_notes.xml:2195 +#: release_notes.xml:2290 #, no-c-format msgid "BUGFIX in GeometryFromText() missing to add a bbox cache." msgstr "" #. Tag: para -#: release_notes.xml:2197 +#: release_notes.xml:2292 #, no-c-format msgid "reduced precision of box2d output." msgstr "" #. Tag: para -#: release_notes.xml:2199 +#: release_notes.xml:2294 #, no-c-format msgid "prefixed DEBUG macros with PGIS_ to avoid clash with pgsql one" msgstr "" #. Tag: para -#: release_notes.xml:2202 +#: release_notes.xml:2297 #, no-c-format msgid "plugged a leak in GEOS2POSTGIS converter" msgstr "" #. Tag: para -#: release_notes.xml:2204 +#: release_notes.xml:2299 #, no-c-format msgid "Reduced memory usage by early releasing query-context palloced one." msgstr "" #. Tag: para -#: release_notes.xml:2211 +#: release_notes.xml:2306 #, no-c-format msgid "BUGFIX in 72 index bindings." msgstr "" #. Tag: para -#: release_notes.xml:2213 +#: release_notes.xml:2308 #, no-c-format msgid "BUGFIX in probe_geometry_columns() to work with PG72 and support multiple geometry columns in a single table" msgstr "" #. Tag: para -#: release_notes.xml:2216 +#: release_notes.xml:2311 #, no-c-format msgid "NEW bool::text cast" msgstr "" #. Tag: para -#: release_notes.xml:2218 +#: release_notes.xml:2313 #, no-c-format msgid "Some functions made IMMUTABLE from STABLE, for performance improvement." msgstr "" #. Tag: para -#: release_notes.xml:2225 +#: release_notes.xml:2320 #, no-c-format msgid "jdbc2: small patches, box2d/3d tests, revised docs and license." msgstr "" #. Tag: para -#: release_notes.xml:2228 +#: release_notes.xml:2323 #, no-c-format msgid "jdbc2: bug fix and testcase in for pgjdbc 8.0 type autoregistration" msgstr "" #. Tag: para -#: release_notes.xml:2231 +#: release_notes.xml:2326 #, no-c-format msgid "jdbc2: Removed use of jdk1.4 only features to enable build with older jdk releases." msgstr "" #. Tag: para -#: release_notes.xml:2234 +#: release_notes.xml:2329 #, no-c-format msgid "jdbc2: Added support for building against pg72jdbc2.jar" msgstr "" #. Tag: para -#: release_notes.xml:2236 +#: release_notes.xml:2331 #, no-c-format msgid "jdbc2: updated and cleaned makefile" msgstr "" #. Tag: para -#: release_notes.xml:2238 +#: release_notes.xml:2333 #, no-c-format msgid "jdbc2: added BETA support for jts geometry classes" msgstr "" #. Tag: para -#: release_notes.xml:2240 +#: release_notes.xml:2335 #, no-c-format msgid "jdbc2: Skip known-to-fail tests against older PostGIS servers." msgstr "" #. Tag: para -#: release_notes.xml:2243 +#: release_notes.xml:2338 #, no-c-format msgid "jdbc2: Fixed handling of measured geometries in EWKT." msgstr "" #. Tag: para -#: release_notes.xml:2249 +#: release_notes.xml:2344 #, no-c-format msgid "new performance tips chapter in manual" msgstr "" #. Tag: para -#: release_notes.xml:2251 +#: release_notes.xml:2346 #, no-c-format msgid "documentation updates: pgsql72 requirement, lwpostgis.sql" msgstr "" #. Tag: para -#: release_notes.xml:2253 +#: release_notes.xml:2348 #, no-c-format msgid "few changes in autoconf" msgstr "" #. Tag: para -#: release_notes.xml:2255 +#: release_notes.xml:2350 #, no-c-format msgid "BUILDDATE extraction made more portable" msgstr "" #. Tag: para -#: release_notes.xml:2257 +#: release_notes.xml:2352 #, no-c-format msgid "fixed spatial_ref_sys.sql to avoid vacuuming the whole database." msgstr "" #. Tag: para -#: release_notes.xml:2260 +#: release_notes.xml:2355 #, no-c-format msgid "spatial_ref_sys: changed Paris entries to match the ones distributed with 0.x." msgstr "" #. Tag: title -#: release_notes.xml:2266 +#: release_notes.xml:2361 #, no-c-format msgid "Release 1.0.0RC2" msgstr "" #. Tag: para -#: release_notes.xml:2268 +#: release_notes.xml:2363 #, no-c-format msgid "Release date: 2005/01/26" msgstr "" #. Tag: para -#: release_notes.xml:2270 +#: release_notes.xml:2365 #, no-c-format msgid "Second release candidate for 1.0.0 containing bug fixes and a few improvements." msgstr "" #. Tag: para -#: release_notes.xml:2284 +#: release_notes.xml:2379 #, no-c-format msgid "BUGFIX in pointarray box3d computation" msgstr "" #. Tag: para -#: release_notes.xml:2286 +#: release_notes.xml:2381 #, no-c-format msgid "BUGFIX in distance_spheroid definition" msgstr "" #. Tag: para -#: release_notes.xml:2288 +#: release_notes.xml:2383 #, no-c-format msgid "BUGFIX in transform() missing to update bbox cache" msgstr "" #. Tag: para -#: release_notes.xml:2290 +#: release_notes.xml:2385 #, no-c-format msgid "NEW jdbc driver (jdbc2)" msgstr "" #. Tag: para -#: release_notes.xml:2292 +#: release_notes.xml:2387 #, no-c-format msgid "GEOMETRYCOLLECTION(EMPTY) syntax support for backward compatibility" msgstr "" #. Tag: para -#: release_notes.xml:2295 +#: release_notes.xml:2390 #, no-c-format msgid "Faster binary outputs" msgstr "" #. Tag: para -#: release_notes.xml:2297 +#: release_notes.xml:2392 #, no-c-format msgid "Stricter OGC WKB/WKT constructors" msgstr "" #. Tag: para -#: release_notes.xml:2303 +#: release_notes.xml:2398 #, no-c-format msgid "More correct STABLE, IMMUTABLE, STRICT uses in lwpostgis.sql" msgstr "" #. Tag: para -#: release_notes.xml:2306 +#: release_notes.xml:2401 #, no-c-format msgid "stricter OGC WKB/WKT constructors" msgstr "" #. Tag: para -#: release_notes.xml:2312 +#: release_notes.xml:2407 #, no-c-format msgid "Faster and more robust loader (both i18n and not)" msgstr "" #. Tag: para -#: release_notes.xml:2314 +#: release_notes.xml:2409 #, no-c-format msgid "Initial autoconf script" msgstr "" #. Tag: title -#: release_notes.xml:2319 +#: release_notes.xml:2414 #, no-c-format msgid "Release 1.0.0RC1" msgstr "" #. Tag: para -#: release_notes.xml:2321 +#: release_notes.xml:2416 #, no-c-format msgid "Release date: 2005/01/13" msgstr "" #. Tag: para -#: release_notes.xml:2323 +#: release_notes.xml:2418 #, no-c-format msgid "This is the first candidate of a major postgis release, with internal storage of postgis types redesigned to be smaller and faster on indexed queries." msgstr "" #. Tag: para -#: release_notes.xml:2338 +#: release_notes.xml:2433 #, no-c-format msgid "Faster canonical input parsing." msgstr "" #. Tag: para -#: release_notes.xml:2340 +#: release_notes.xml:2435 #, no-c-format msgid "Lossless canonical output." msgstr "" #. Tag: para -#: release_notes.xml:2342 +#: release_notes.xml:2437 #, no-c-format msgid "EWKB Canonical binary IO with PG>73." msgstr "" #. Tag: para -#: release_notes.xml:2344 +#: release_notes.xml:2439 #, no-c-format msgid "Support for up to 4d coordinates, providing lossless shapefile->postgis->shapefile conversion." msgstr "" #. Tag: para -#: release_notes.xml:2347 +#: release_notes.xml:2442 #, no-c-format msgid "New function: UpdateGeometrySRID(), AsGML(), SnapToGrid(), ForceRHR(), estimated_extent(), accum()." msgstr "" #. Tag: para -#: release_notes.xml:2350 +#: release_notes.xml:2445 #, no-c-format msgid "Vertical positioning indexed operators." msgstr "" #. Tag: para -#: release_notes.xml:2352 +#: release_notes.xml:2447 #, no-c-format msgid "JOIN selectivity function." msgstr "" #. Tag: para -#: release_notes.xml:2354 +#: release_notes.xml:2449 #, no-c-format msgid "More geometry constructors / editors." msgstr "" #. Tag: para -#: release_notes.xml:2356 +#: release_notes.xml:2451 #, no-c-format msgid "PostGIS extension API." msgstr "" #. Tag: para -#: release_notes.xml:2358 +#: release_notes.xml:2453 #, no-c-format msgid "UTF8 support in loader." msgstr "" diff --git a/doc/po/templates/using_raster_dataman.xml.pot b/doc/po/templates/using_raster_dataman.xml.pot index f496da56b..8114334f5 100644 --- a/doc/po/templates/using_raster_dataman.xml.pot +++ b/doc/po/templates/using_raster_dataman.xml.pot @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2014-10-18 10:29+0000\n" +"POT-Creation-Date: 2015-09-29 12:21+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -239,197 +239,239 @@ msgstr "" #. Tag: term #: using_raster_dataman.xml:158 #, no-c-format -msgid "-R, --register" +msgid "-P" msgstr "" #. Tag: para #: using_raster_dataman.xml:160 #, no-c-format +msgid "Pad right-most and bottom-most tiles to guarantee that all tiles have the same width and height." +msgstr "" + +#. Tag: term +#: using_raster_dataman.xml:170 +#, no-c-format +msgid "-R, --register" +msgstr "" + +#. Tag: para +#: using_raster_dataman.xml:172 +#, no-c-format msgid "Register the raster as a filesystem (out-db) raster." msgstr "" #. Tag: para -#: using_raster_dataman.xml:161 +#: using_raster_dataman.xml:173 #, no-c-format msgid "Only the metadata of the raster and path location to the raster is stored in the database (not the pixels)." msgstr "" #. Tag: term -#: using_raster_dataman.xml:166 +#: using_raster_dataman.xml:178 #, no-c-format msgid "-l OVERVIEW_FACTOR" msgstr "" #. Tag: para -#: using_raster_dataman.xml:167 +#: using_raster_dataman.xml:179 #, no-c-format msgid "Create overview of the raster. For more than one factor, separate with comma(,). Overview table name follows the pattern o_overview factor_table, where overview factor is a placeholder for numerical overview factor and table is replaced with the base table name. Created overview is stored in the database and is not affected by -R. Note that your generated sql file will contain both the main table and overview tables." msgstr "" #. Tag: term -#: using_raster_dataman.xml:175 +#: using_raster_dataman.xml:187 #, no-c-format msgid "-N NODATA" msgstr "" #. Tag: para -#: using_raster_dataman.xml:177 +#: using_raster_dataman.xml:189 #, no-c-format msgid "NODATA value to use on bands without a NODATA value." msgstr "" #. Tag: term -#: using_raster_dataman.xml:189 +#: using_raster_dataman.xml:201 #, no-c-format msgid "Optional parameters used to manipulate database objects" msgstr "" #. Tag: term -#: using_raster_dataman.xml:194 +#: using_raster_dataman.xml:206 using_raster_dataman.xml:235 #, no-c-format msgid "-q" msgstr "" #. Tag: para -#: using_raster_dataman.xml:196 +#: using_raster_dataman.xml:208 #, no-c-format msgid "Wrap PostgreSQL identifiers in quotes" msgstr "" #. Tag: term -#: using_raster_dataman.xml:201 +#: using_raster_dataman.xml:213 #, no-c-format msgid "-f COLUMN" msgstr "" #. Tag: para -#: using_raster_dataman.xml:203 +#: using_raster_dataman.xml:215 #, no-c-format msgid "Specify name of destination raster column, default is 'rast'" msgstr "" #. Tag: term -#: using_raster_dataman.xml:209 +#: using_raster_dataman.xml:221 #, no-c-format msgid "-F" msgstr "" #. Tag: para -#: using_raster_dataman.xml:211 +#: using_raster_dataman.xml:223 #, no-c-format msgid "Add a column with the name of the file" msgstr "" #. Tag: term -#: using_raster_dataman.xml:216 +#: using_raster_dataman.xml:228 +#, no-c-format +msgid "-n COLUMN" +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 #, no-c-format msgid "-I" msgstr "" #. Tag: para -#: using_raster_dataman.xml:218 +#: using_raster_dataman.xml:244 #, no-c-format msgid "Create a GiST index on the raster column." msgstr "" #. Tag: term -#: using_raster_dataman.xml:225 +#: using_raster_dataman.xml:251 #, no-c-format msgid "-M" msgstr "" #. Tag: para -#: using_raster_dataman.xml:227 +#: using_raster_dataman.xml:253 #, no-c-format msgid "Vacuum analyze the raster table." msgstr "" #. Tag: term -#: using_raster_dataman.xml:234 +#: using_raster_dataman.xml:261 +#, no-c-format +msgid "-k" +msgstr "" + +#. Tag: para +#: using_raster_dataman.xml:263 +#, no-c-format +msgid "Skip NODATA value checks for each raster band." +msgstr "" + +#. Tag: term +#: using_raster_dataman.xml:271 #, no-c-format msgid "-T tablespace" msgstr "" #. Tag: para -#: using_raster_dataman.xml:236 +#: using_raster_dataman.xml:273 #, no-c-format msgid "Specify the tablespace for the new table. Note that indices (including the primary key) will still use the default tablespace unless the -X flag is also used." msgstr "" #. Tag: term -#: using_raster_dataman.xml:245 +#: using_raster_dataman.xml:282 #, no-c-format msgid "-X tablespace" msgstr "" #. Tag: para -#: using_raster_dataman.xml:247 +#: using_raster_dataman.xml:284 #, no-c-format msgid "Specify the tablespace for the table's new index. This applies to the primary key and the spatial index if the -I flag is used." msgstr "" #. Tag: term -#: using_raster_dataman.xml:256 +#: using_raster_dataman.xml:293 #, no-c-format msgid "-Y" msgstr "" #. Tag: para -#: using_raster_dataman.xml:258 +#: using_raster_dataman.xml:295 #, no-c-format msgid "Use copy statements instead of insert statements." msgstr "" #. Tag: term -#: using_raster_dataman.xml:269 +#: using_raster_dataman.xml:306 #, no-c-format msgid "-e" msgstr "" #. Tag: para -#: using_raster_dataman.xml:270 +#: using_raster_dataman.xml:307 #, no-c-format msgid "Execute each statement individually, do not use a transaction." msgstr "" #. Tag: term -#: using_raster_dataman.xml:274 +#: using_raster_dataman.xml:311 #, no-c-format msgid "-E ENDIAN" msgstr "" #. Tag: para -#: using_raster_dataman.xml:275 +#: using_raster_dataman.xml:312 #, no-c-format msgid "Control endianness of generated binary output of raster; specify 0 for XDR and 1 for NDR (default); only NDR output is supported now" msgstr "" #. Tag: term -#: using_raster_dataman.xml:279 +#: using_raster_dataman.xml:316 #, no-c-format msgid "-V version" msgstr "" #. Tag: para -#: using_raster_dataman.xml:280 +#: using_raster_dataman.xml:317 #, no-c-format msgid "Specify version of output format. Default is 0. Only 0 is supported at this time." msgstr "" #. Tag: para -#: using_raster_dataman.xml:283 +#: using_raster_dataman.xml:320 #, no-c-format msgid "An example session using the loader to create an input file and uploading it chunked in 100x100 tiles might look like this:" msgstr "" #. Tag: para -#: using_raster_dataman.xml:284 +#: using_raster_dataman.xml:321 #, no-c-format msgid "You can leave the schema name out e.g demelevation instead of public.demelevation and the raster table will be created in the default schema of the database or user" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:286 +#: using_raster_dataman.xml:323 #, no-c-format msgid "" "raster2pgsql -s 4326 -I -C -M *.tif -F -t 100x100 public.demelevation > elev.sql\n" @@ -437,31 +479,31 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:288 +#: using_raster_dataman.xml:325 #, 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:290 +#: using_raster_dataman.xml:327 #, no-c-format msgid "raster2pgsql -s 4326 -I -C -M *.tif -F -t 100x100 public.demelevation | psql -d gisdb" msgstr "" #. Tag: para -#: using_raster_dataman.xml:292 +#: using_raster_dataman.xml:329 #, no-c-format msgid "Load rasters Massachusetts state plane meters aerial tiles into a schema called aerial and create a full view, 2 and 4 level overview tables, use copy mode for inserting (no intermediary file just straight to db), and -e don't force everything in a transaction (good if you want to see data in tables right away without waiting). Break up the rasters into 128x128 pixel tiles and apply raster constraints. Use copy mode instead of table insert. (-F) Include a field called filename to hold the name of the file the tiles were cut from." msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:294 +#: using_raster_dataman.xml:331 #, no-c-format msgid "raster2pgsql -I -C -e -Y -F -s 26986 -t 128x128 -l 2,4 bostonaerials2008/*.jpg aerials.boston | psql -U postgres -d gisdb -h localhost -p 5432" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:296 +#: using_raster_dataman.xml:333 #, no-c-format msgid "" "--get a list of raster types supported:\n" @@ -469,13 +511,13 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:298 +#: using_raster_dataman.xml:335 #, no-c-format msgid "The -G commands outputs a list something like" msgstr "" #. Tag: screen -#: using_raster_dataman.xml:299 +#: using_raster_dataman.xml:336 #, no-c-format msgid "" "Available GDAL raster formats:\n" @@ -579,361 +621,361 @@ msgid "" msgstr "" #. Tag: title -#: using_raster_dataman.xml:302 +#: using_raster_dataman.xml:339 #, no-c-format msgid "Creating rasters using PostGIS raster functions" msgstr "" #. Tag: para -#: using_raster_dataman.xml:303 +#: using_raster_dataman.xml:340 #, no-c-format msgid "On many occasions, you'll want to create rasters and raster tables right in the database. There are a plethora of functions to do that. The general steps to follow." msgstr "" #. Tag: para -#: using_raster_dataman.xml:305 +#: using_raster_dataman.xml:342 #, no-c-format msgid "Create a table with a raster column to hold the new raster records which can be accomplished with:" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:306 +#: using_raster_dataman.xml:343 #, no-c-format msgid "CREATE TABLE myrasters(rid serial primary key, rast raster);" msgstr "" #. Tag: para -#: using_raster_dataman.xml:309 +#: using_raster_dataman.xml:346 #, no-c-format msgid "There are many functions to help with that goal. If you are creating rasters not as a derivative of other rasters, you will want to start with: , followed by " msgstr "" #. Tag: para -#: using_raster_dataman.xml:311 +#: using_raster_dataman.xml:348 #, no-c-format msgid "You can also create rasters from geometries. To achieve that you'll want to use perhaps accompanied with other functions such as or or any of the family of other map algebra functions." msgstr "" #. Tag: para -#: using_raster_dataman.xml:313 +#: using_raster_dataman.xml:350 #, no-c-format msgid "There are even many more options for creating new raster tables from existing tables. For example you can create a raster table in a different projection from an existing one using " msgstr "" #. Tag: para -#: using_raster_dataman.xml:315 +#: using_raster_dataman.xml:352 #, no-c-format msgid "Once you are done populating your table initially, you'll want to create a spatial index on the raster column with something like:" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:316 +#: using_raster_dataman.xml:353 #, no-c-format msgid "CREATE INDEX myrasters_rast_st_convexhull_idx ON myrasters USING gist( ST_ConvexHull(rast) );" msgstr "" #. Tag: para -#: using_raster_dataman.xml:317 +#: using_raster_dataman.xml:354 #, no-c-format msgid "Note the use of since most raster operators are based on the convex hull of the rasters." msgstr "" #. Tag: para -#: using_raster_dataman.xml:318 +#: using_raster_dataman.xml:355 #, no-c-format msgid "Pre-2.0 versions of PostGIS raster were based on the envelop rather than the convex hull. For the spatial indexes to work properly you'll need to drop those and replace with convex hull based index." msgstr "" #. Tag: para -#: using_raster_dataman.xml:319 +#: using_raster_dataman.xml:356 #, no-c-format msgid "Apply raster constraints using " msgstr "" #. Tag: title -#: using_raster_dataman.xml:324 +#: using_raster_dataman.xml:361 #, no-c-format msgid "Raster Catalogs" msgstr "" #. Tag: para -#: using_raster_dataman.xml:325 +#: using_raster_dataman.xml:362 #, no-c-format msgid "There are two raster catalog views that come packaged with PostGIS. Both views utilize information embedded in the constraints of the raster tables. As a result the catalog views are always consistent with the raster data in the tables since the constraints are enforced." msgstr "" #. Tag: para -#: using_raster_dataman.xml:329 +#: using_raster_dataman.xml:366 #, no-c-format msgid "raster_columns this view catalogs all the raster table columns in your database." msgstr "" #. Tag: para -#: using_raster_dataman.xml:332 +#: using_raster_dataman.xml:369 #, no-c-format msgid "raster_overviews this view catalogs all the raster table columns in your database that serve as overviews for a finer grained table. Tables of this type are generated when you use the -l switch during load." msgstr "" #. Tag: title -#: using_raster_dataman.xml:336 +#: using_raster_dataman.xml:373 #, no-c-format msgid "Raster Columns Catalog" msgstr "" #. Tag: para -#: using_raster_dataman.xml:337 +#: using_raster_dataman.xml:374 #, no-c-format msgid "The raster_columns is a catalog of all raster table columns in your database that are of type raster. It is a view utilizing the constraints on the tables so the information is always consistent even if you restore one raster table from a backup of another database. The following columns exist in the raster_columns catalog." msgstr "" #. Tag: para -#: using_raster_dataman.xml:339 +#: using_raster_dataman.xml:376 #, no-c-format msgid "If you created your tables not with the loader or forgot to specify the -C flag during load, you can enforce the constraints after the fact using so that the raster_columns catalog registers the common information about your raster tiles." msgstr "" #. Tag: para -#: using_raster_dataman.xml:344 +#: using_raster_dataman.xml:381 #, no-c-format msgid "r_table_catalog The database the table is in. This will always read the current database." msgstr "" #. Tag: para -#: using_raster_dataman.xml:347 +#: using_raster_dataman.xml:384 #, no-c-format msgid "r_table_schema The database schema the raster table belongs to." msgstr "" #. Tag: para -#: using_raster_dataman.xml:350 +#: using_raster_dataman.xml:387 #, no-c-format msgid "r_table_name raster table" msgstr "" #. Tag: para -#: using_raster_dataman.xml:353 +#: using_raster_dataman.xml:390 #, no-c-format msgid "r_raster_column the column in the r_table_name table that is of type raster. There is nothing in PostGIS preventing you from having multiple raster columns per table so its possible to have a raster table listed multiple times with a different raster column for each." msgstr "" #. Tag: para -#: using_raster_dataman.xml:356 +#: using_raster_dataman.xml:393 #, no-c-format msgid "srid The spatial reference identifier of the raster. Should be an entry in the ." msgstr "" #. Tag: para -#: using_raster_dataman.xml:359 +#: using_raster_dataman.xml:396 #, no-c-format msgid "scale_x The scaling between geometric spatial coordinates and pixel. This is only available if all tiles in the raster column have the same scale_x and this constraint is applied. Refer to for more details." msgstr "" #. Tag: para -#: using_raster_dataman.xml:362 +#: using_raster_dataman.xml:399 #, no-c-format msgid "scale_y The scaling between geometric spatial coordinates and pixel. This is only available if all tiles in the raster column have the same scale_y and the scale_y constraint is applied. Refer to for more details." msgstr "" #. Tag: para -#: using_raster_dataman.xml:365 +#: using_raster_dataman.xml:402 #, no-c-format msgid "blocksize_x The width (number of pixels across) of each raster tile . Refer to for more details." msgstr "" #. Tag: para -#: using_raster_dataman.xml:368 +#: using_raster_dataman.xml:405 #, no-c-format msgid "blocksize_y The width (number of pixels down) of each raster tile . Refer to for more details." msgstr "" #. Tag: para -#: using_raster_dataman.xml:371 +#: using_raster_dataman.xml:408 #, no-c-format msgid "same_alignment A boolean that is true if all the raster tiles have the same alignment . Refer to for more details." msgstr "" #. Tag: para -#: using_raster_dataman.xml:374 +#: using_raster_dataman.xml:411 #, no-c-format msgid "regular_blocking If the raster column has the spatially unique and coverage tile constraints, the value with be TRUE. Otherwise, it will be FALSE." msgstr "" #. Tag: para -#: using_raster_dataman.xml:377 +#: using_raster_dataman.xml:414 #, no-c-format msgid "num_bands The number of bands in each tile of your raster set. This is the same information as what is provided by" msgstr "" #. Tag: para -#: using_raster_dataman.xml:380 +#: using_raster_dataman.xml:417 #, no-c-format msgid "pixel_types An array defining the pixel type for each band. You will have the same number of elements in this array as you have number of bands. The pixel_types are one of the following defined in ." msgstr "" #. Tag: para -#: using_raster_dataman.xml:383 +#: using_raster_dataman.xml:420 #, no-c-format msgid "nodata_values An array of double precision numbers denoting the nodata_value for each band. You will have the same number of elements in this array as you have number of bands. These numbers define the pixel value for each band that should be ignored for most operations. This is similar information provided by ." msgstr "" #. Tag: para -#: using_raster_dataman.xml:386 +#: using_raster_dataman.xml:423 #, no-c-format msgid "out_db An array of boolean flags indicating if the raster bands data is maintained outside the database. You will have the same number of elements in this array as you have number of bands." msgstr "" #. Tag: para -#: using_raster_dataman.xml:389 +#: using_raster_dataman.xml:426 #, no-c-format msgid "extent This is the extent of all the raster rows in your raster set. If you plan to load more data that will change the extent of the set, you'll want to run the function before load and then reapply constraints with after load." msgstr "" #. Tag: para -#: using_raster_dataman.xml:392 +#: using_raster_dataman.xml:429 #, no-c-format msgid "spatial_index A boolean that is true if raster column has a spatial index." msgstr "" #. Tag: title -#: using_raster_dataman.xml:397 +#: using_raster_dataman.xml:434 #, no-c-format msgid "Raster Overviews" msgstr "" #. Tag: para -#: using_raster_dataman.xml:398 +#: using_raster_dataman.xml:435 #, no-c-format msgid "raster_overviews catalogs information about raster table columns used for overviews and additional information about them that is useful to know when utilizing overviews. Overview tables are cataloged in both raster_columns and raster_overviews because they are rasters in their own right but also serve an additional special purpose of being a lower resolution caricature of a higher resolution table. These are generated along-side the main raster table when you use the -l switch in raster loading or can be generated manually using ." msgstr "" #. Tag: para -#: using_raster_dataman.xml:399 +#: using_raster_dataman.xml:436 #, no-c-format msgid "Overview tables contain the same constraints as other raster tables as well as additional informational only constraints specific to overviews." msgstr "" #. Tag: para -#: using_raster_dataman.xml:400 +#: using_raster_dataman.xml:437 #, no-c-format msgid "The information in raster_overviews does not duplicate the information in raster_columns. If you need the information about an overview table present in raster_columns you can join the raster_overviews and raster_columns together to get the full set of information you need." msgstr "" #. Tag: para -#: using_raster_dataman.xml:401 +#: using_raster_dataman.xml:438 #, no-c-format msgid "Two main reasons for overviews are:" msgstr "" #. Tag: para -#: using_raster_dataman.xml:403 +#: using_raster_dataman.xml:440 #, no-c-format msgid "Low resolution representation of the core tables commonly used for fast mapping zoom-out." msgstr "" #. Tag: para -#: using_raster_dataman.xml:404 +#: using_raster_dataman.xml:441 #, no-c-format msgid "Computations are generally faster to do on them than their higher resolution parents because there are fewer records and each pixel covers more territory. Though the computations are not as accurate as the high-res tables they support, they can be sufficient in many rule-of-thumb computations." msgstr "" #. Tag: para -#: using_raster_dataman.xml:407 +#: using_raster_dataman.xml:444 #, no-c-format msgid "The raster_overviews catalog contains the following columns of information." msgstr "" #. Tag: para -#: using_raster_dataman.xml:410 +#: using_raster_dataman.xml:447 #, no-c-format msgid "o_table_catalog The database the overview table is in. This will always read the current database." msgstr "" #. Tag: para -#: using_raster_dataman.xml:413 +#: using_raster_dataman.xml:450 #, no-c-format msgid "o_table_schema The database schema the overview raster table belongs to." msgstr "" #. Tag: para -#: using_raster_dataman.xml:416 +#: using_raster_dataman.xml:453 #, no-c-format msgid "o_table_name raster overview table name" msgstr "" #. Tag: para -#: using_raster_dataman.xml:419 +#: using_raster_dataman.xml:456 #, no-c-format msgid "o_raster_column the raster column in the overview table." msgstr "" #. Tag: para -#: using_raster_dataman.xml:423 +#: using_raster_dataman.xml:460 #, no-c-format msgid "r_table_catalog The database the raster table that this overview services is in. This will always read the current database." msgstr "" #. Tag: para -#: using_raster_dataman.xml:426 +#: using_raster_dataman.xml:463 #, no-c-format msgid "r_table_schema The database schema the raster table that this overview services belongs to." msgstr "" #. Tag: para -#: using_raster_dataman.xml:429 +#: using_raster_dataman.xml:466 #, no-c-format msgid "r_table_name raster table that this overview services." msgstr "" #. Tag: para -#: using_raster_dataman.xml:432 +#: using_raster_dataman.xml:469 #, no-c-format msgid "r_raster_column the raster column that this overview column services." msgstr "" #. Tag: para -#: using_raster_dataman.xml:435 +#: using_raster_dataman.xml:472 #, no-c-format msgid "overview_factor - this is the pyramid level of the overview table. The higher the number the lower the resolution of the table. raster2pgsql if given a folder of images, will compute overview of each image file and load separately. Level 1 is assumed and always the original file. Level 2 is will have each tile represent 4 of the original. So for example if you have a folder of 5000x5000 pixel image files that you chose to chunk 125x125, for each image file your base table will have (5000*5000)/(125*125) records = 1600, your (l=2) o_2 table will have ceiling(1600/Power(2,2)) = 400 rows, your (l=3) o_3 will have ceiling(1600/Power(2,3) ) = 200 rows. If your pixels aren't divisible by the size of your tiles, you'll get some scrap tiles (tiles not completely filled). Note that each overview tile generated by raster2pgsql has the same number of pixels as its parent, but is of a lower resolution where each pixel of it represents (Power(2,overview_factor) pixels of the original)." msgstr "" #. Tag: title -#: using_raster_dataman.xml:447 +#: using_raster_dataman.xml:484 #, no-c-format msgid "Building Custom Applications with PostGIS Raster" msgstr "" #. Tag: para -#: using_raster_dataman.xml:448 +#: using_raster_dataman.xml:485 #, no-c-format msgid "The fact that PostGIS raster provides you with SQL functions to render rasters in known image formats gives you a lot of optoins for rendering them. For example you can use OpenOffice / LibreOffice for rendering as demonstrated in Rendering PostGIS Raster graphics with LibreOffice Base Reports. In addition you can use a wide variety of languages as demonstrated in this section." msgstr "" #. Tag: title -#: using_raster_dataman.xml:451 +#: using_raster_dataman.xml:488 #, no-c-format msgid "PHP Example Outputting using ST_AsPNG in concert with other raster functions" msgstr "" #. Tag: para -#: using_raster_dataman.xml:452 +#: using_raster_dataman.xml:489 #, no-c-format msgid "In this section, we'll demonstrate how to use the PHP PostgreSQL driver and the family of functions to output band 1,2,3 of a raster to a PHP request stream that can then be embedded in an img src html tag." msgstr "" #. Tag: para -#: using_raster_dataman.xml:455 using_raster_dataman.xml:467 +#: using_raster_dataman.xml:492 using_raster_dataman.xml:504 #, no-c-format msgid "The sample query demonstrates how to combine a whole bunch of raster functions together to grab all tiles that intersect a particular wgs 84 bounding box and then unions with the intersecting tiles together returning all bands, transforms to user specified projection using , and then outputs the results as a png using ." msgstr "" #. Tag: para -#: using_raster_dataman.xml:458 +#: using_raster_dataman.xml:495 #, no-c-format msgid "You would call the below using http://mywebserver/test_raster.php?srid=2249 to get the raster image in Massachusetts state plane feet." msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:459 +#: using_raster_dataman.xml:496 #, no-c-format msgid "" " family of functions to output band 1,2,3 of a raster to a PHP request stream that can then be embedded in an img src html tag." msgstr "" #. Tag: para -#: using_raster_dataman.xml:466 +#: using_raster_dataman.xml:503 #, no-c-format msgid "You will need the npgsql .NET PostgreSQL driver for this exercise which you can get the latest of from http://npgsql.projects.postgresql.org/. Just download the latest and drop into your ASP.NET bin folder and you'll be good to go." msgstr "" #. Tag: para -#: using_raster_dataman.xml:470 +#: using_raster_dataman.xml:507 #, no-c-format msgid "This is same example as except implemented in C#." msgstr "" #. Tag: para -#: using_raster_dataman.xml:471 +#: using_raster_dataman.xml:508 #, no-c-format msgid "You would call the below using http://mywebserver/TestRaster.ashx?srid=2249 to get the raster image in Massachusetts state plane feet." msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:472 +#: using_raster_dataman.xml:509 #, no-c-format msgid "" "-- web.config connection string section --\n" @@ -1004,7 +1046,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:473 +#: using_raster_dataman.xml:510 #, no-c-format msgid "" "// Code for TestRaster.ashx\n" @@ -1071,31 +1113,31 @@ msgid "" msgstr "" #. Tag: title -#: using_raster_dataman.xml:476 +#: using_raster_dataman.xml:513 #, no-c-format msgid "Java console app that outputs raster query as Image file" msgstr "" #. Tag: para -#: using_raster_dataman.xml:477 +#: using_raster_dataman.xml:514 #, no-c-format msgid "This is a simple java console app that takes a query that returns one image and outputs to specified file." msgstr "" #. Tag: para -#: using_raster_dataman.xml:478 +#: using_raster_dataman.xml:515 #, no-c-format msgid "You can download the latest PostgreSQL JDBC drivers from http://jdbc.postgresql.org/download.html" msgstr "" #. Tag: para -#: using_raster_dataman.xml:479 +#: using_raster_dataman.xml:516 #, no-c-format msgid "You can compile the following code using a command something like:" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:480 +#: using_raster_dataman.xml:517 #, no-c-format msgid "" "set env CLASSPATH .:..\\postgresql-9.0-801.jdbc4.jar\n" @@ -1104,19 +1146,19 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:481 +#: using_raster_dataman.xml:518 #, no-c-format msgid "And call it from the command-line with something like" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:482 +#: using_raster_dataman.xml:519 #, no-c-format msgid "java -jar SaveQueryImage.jar \"SELECT ST_AsPNG(ST_AsRaster(ST_Buffer(ST_Point(1,5),10, 'quad_segs=2'),150, 150, '8BUI',100));\" \"test.png\"" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:483 +#: using_raster_dataman.xml:520 #, no-c-format msgid "" "-- Manifest.txt --\n" @@ -1125,7 +1167,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:484 +#: using_raster_dataman.xml:521 #, no-c-format msgid "" "// Code for SaveQueryImage.java\n" @@ -1188,19 +1230,19 @@ msgid "" msgstr "" #. Tag: title -#: using_raster_dataman.xml:488 +#: using_raster_dataman.xml:525 #, no-c-format msgid "Use PLPython to dump out images via SQL" msgstr "" #. Tag: para -#: using_raster_dataman.xml:489 +#: using_raster_dataman.xml:526 #, no-c-format msgid "This is a plpython stored function that creates a file in the server directory for each record. Requires you have plpython installed. Should work fine with both plpythonu and plpython3u." msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:491 +#: using_raster_dataman.xml:528 #, no-c-format msgid "" "Clever Trick Challenge -- Outputting bytea with psql that piggy backs on PostgreSQL somewhat legacy large object support. To use first launch your psql commandline connected to your database." msgstr "" #. Tag: para -#: using_raster_dataman.xml:499 +#: using_raster_dataman.xml:536 #, no-c-format msgid "Unlike the python approach, this approach creates the file on your local computer." msgstr "" #. Tag: screen -#: using_raster_dataman.xml:500 +#: using_raster_dataman.xml:537 #, no-c-format msgid "" "SELECT oid, lowrite(lo_open(oid, 131072), png) As num_bytes\n"