Movatterモバイル変換


[0]ホーム

URL:



Facebook
Postgres Pro
Facebook
Downloads
F.58. seg — a datatype for line segments or floating point intervals
Prev UpAppendix F. Additional Supplied Modules and Extensions Shipped inpostgrespro-std-17-contribHome Next

F.58. seg — a datatype for line segments or floating point intervals#

This module implements a data typeseg for representing line segments, or floating point intervals.seg can represent uncertainty in the interval endpoints, making it especially useful for representing laboratory measurements.

This module is consideredtrusted, that is, it can be installed by non-superusers who haveCREATE privilege on the current database.

F.58.1. Rationale#

The geometry of measurements is usually more complex than that of a point in a numeric continuum. A measurement is usually a segment of that continuum with somewhat fuzzy limits. The measurements come out as intervals because of uncertainty and randomness, as well as because the value being measured may naturally be an interval indicating some condition, such as the temperature range of stability of a protein.

Using just common sense, it appears more convenient to store such data as intervals, rather than pairs of numbers. In practice, it even turns out more efficient in most applications.

Further along the line of common sense, the fuzziness of the limits suggests that the use of traditional numeric data types leads to a certain loss of information. Consider this: your instrument reads 6.50, and you input this reading into the database. What do you get when you fetch it? Watch:

test=> select 6.50 :: float8 as "pH"; pH---6.5(1 row)

In the world of measurements, 6.50 is not the same as 6.5. It may sometimes be critically different. The experimenters usually write down (and publish) the digits they trust. 6.50 is actually a fuzzy interval contained within a bigger and even fuzzier interval, 6.5, with their center points being (probably) the only common feature they share. We definitely do not want such different data items to appear the same.

Conclusion? It is nice to have a special data type that can record the limits of an interval with arbitrarily variable precision. Variable in the sense that each data element records its own precision.

Check this out:

test=> select '6.25 .. 6.50'::seg as "pH";          pH------------6.25 .. 6.50(1 row)

F.58.2. Syntax#

The external representation of an interval is formed using one or two floating-point numbers joined by the range operator (.. or...). Alternatively, it can be specified as a center point plus or minus a deviation. Optional certainty indicators (<,> or~) can be stored as well. (Certainty indicators are ignored by all the built-in operators, however.)Table F.36 gives an overview of allowed representations;Table F.37 shows some examples.

InTable F.36,x,y, anddelta denote floating-point numbers.x andy, but notdelta, can be preceded by a certainty indicator.

Table F.36. seg External Representations

xSingle value (zero-length interval)
x ..yInterval fromx toy
x (+-)deltaInterval fromx -delta tox +delta
x ..Open interval with lower boundx
..xOpen interval with upper boundx

Table F.37. Examples of Validseg Input

5.0 Creates a zero-length segment (a point, if you will)
~5.0 Creates a zero-length segment and records~ in the data.~ is ignored byseg operations, but is preserved as a comment.
<5.0 Creates a point at 5.0.< is ignored but is preserved as a comment.
>5.0 Creates a point at 5.0.> is ignored but is preserved as a comment.
5(+-)0.3 Creates an interval4.7 .. 5.3. Note that the(+-) notation isn't preserved.
50 ..Everything that is greater than or equal to 50
.. 0Everything that is less than or equal to 0
1.5e-2 .. 2E-2Creates an interval0.015 .. 0.02
1 ... 2 The same as1...2, or1 .. 2, or1..2 (spaces around the range operator are ignored)

Because the... operator is widely used in data sources, it is allowed as an alternative spelling of the.. operator. Unfortunately, this creates a parsing ambiguity: it is not clear whether the upper bound in0...23 is meant to be23 or0.23. This is resolved by requiring at least one digit before the decimal point in all numbers inseg input.

As a sanity check,seg rejects intervals with the lower bound greater than the upper, for example5 .. 2.

F.58.3. Precision#

seg values are stored internally as pairs of 32-bit floating point numbers. This means that numbers with more than 7 significant digits will be truncated.

Numbers with 7 or fewer significant digits retain their original precision. That is, if your query returns 0.00, you will be sure that the trailing zeroes are not the artifacts of formatting: they reflect the precision of the original data. The number of leading zeroes does not affect precision: the value 0.0067 is considered to have just 2 significant digits.

F.58.4. Usage#

Theseg module includes a GiST index operator class forseg values. The operators supported by the GiST operator class are shown inTable F.38.

Table F.38. Seg GiST Operators

Operator

Description

seg<<segboolean

Is the firstseg entirely to the left of the second? [a, b] << [c, d] is true if b < c.

seg>>segboolean

Is the firstseg entirely to the right of the second? [a, b] >> [c, d] is true if a > d.

seg&<segboolean

Does the firstseg not extend to the right of the second? [a, b] &< [c, d] is true if b <= d.

seg&>segboolean

Does the firstseg not extend to the left of the second? [a, b] &> [c, d] is true if a >= c.

seg=segboolean

Are the twosegs equal?

seg&&segboolean

Do the twosegs overlap?

seg@>segboolean

Does the firstseg contain the second?

seg<@segboolean

Is the firstseg contained in the second?


In addition to the above operators, the usual comparison operators shown inTable 9.1 are available for typeseg. These operators first compare (a) to (c), and if these are equal, compare (b) to (d). That results in reasonably good sorting in most cases, which is useful if you want to use ORDER BY with this type.

F.58.5. Notes#

For examples of usage, see the regression testsql/seg.sql.

The mechanism that converts(+-) to regular ranges isn't completely accurate in determining the number of significant digits for the boundaries. For example, it adds an extra digit to the lower boundary if the resulting interval includes a power of ten:

postgres=> select '10(+-)1'::seg as seg;      seg---------9.0 .. 11             -- should be: 9 .. 11

The performance of an R-tree index can largely depend on the initial order of input values. It may be very helpful to sort the input table on theseg column; see the scriptsort-segments.pl for an example.

F.58.6. Credits#

Original author: Gene Selkov, Jr.<selkovjr@mcs.anl.gov>, Mathematics and Computer Science Division, Argonne National Laboratory.

My thanks are primarily to Prof. Joe Hellerstein (https://dsf.berkeley.edu/jmh/) for elucidating the gist of the GiST (http://gist.cs.berkeley.edu/). I am also grateful to all Postgres developers, present and past, for enabling myself to create my own world and live undisturbed in it. And I would like to acknowledge my gratitude to Argonne Lab and to the U.S. Department of Energy for the years of faithful support of my database research.


Prev Up Next
F.57. rum — an access method to work with theRUM indexes Home F.59. sepgsql — SELinux-, label-based mandatory access control (MAC) security module
pdfepub
Go to Postgres Pro Standard 17
By continuing to browse this website, you agree to the use of cookies. Go toPrivacy Policy.

[8]ページ先頭

©2009-2025 Movatter.jp