File containing the implementation of the SegmentST data type. More...

Functions
pointsp	atinstantsp (segmentst segment, timestamp ts, boolean checkcontainment=true)
	This function takes a segment and a timestamp as parameters and returns the point where the object was found at the given timestamp. More...

pointst	atinstant (segmentst segment, timestamp ts, boolean checkcontainment=true)
	This function takes a segment and a timestamp as parameters and returns the point where the object was found at the given timestamp. More...

void	atperiodsp (segmentst segment, period period, integer n, segmentsp s, pointsp p)
	This function takes a segment and a period as parameters and returns the part of the segment that corresponds to the given period. The segment might have only one timestamp in common with the period so in that case the function returns a point instead of a segment. This is why the function returns three columns (n, s, p) where n is the number of common points, s is the segment within the period (if n is 2) and p is the point that the segment was within the period (if n is 1). More...

void	atperiod (segmentst segment, period period, integer n, segmentst s, pointst p)
	This function takes a segment and a period as parameters and returns the part of the segment that corresponds to the given period. The segment might have only one timestamp in common with the period so in that case the function returns a point instead of a segment. This is why the function returns three columns (n, s, p) where n is the number of common points, s is the segment within the period (if n is 2) and p is the point that the segment was within the period (if n is 1). More...

timestamp	atpointt (segmentst segment, pointsp point, boolean checkcontainment=true)
	This function takes a segment and a point as parameters and returns the timestamp at which the object was found at the given point. The point has to be on the segment, otherwise the function returns NULL. The value “false” on the last parameter enforces it to avoid checking for containment. In contrast, if the value of the third parameter is set to “yes” then the cost of the calculation gets higher. More...

pointst	atpoint (segmentst segment, pointsp point, boolean checkcontainment=true)
	This function takes a segment and a point as parameters and returns the timestamp at which the object was found at the given point. The point has to be on the segment, otherwise the function returns NULL. The value “false” on the last parameter enforces it to avoid checking for containment. In contrast, if the value of the third parameter is set to “yes” then the cost of the calculation gets higher. More...

void	atboxt (segmentst segment, boxsp box, integer n, period p, timestamp ts)
	This function takes a segment and a box as parameters and returns the part of the segment that resides within the box. Just as atinstant() method the function returns three columns (n, s, p) where n informs whether the result is a point (value 1) or a segment (value 2) or there is no intersection between the segment and the box (value 0). Especially for values 1 and 2 of property “n”, “p” gets the point and “s” gets the segment, respectively. More...

void	atbox (segmentst segment, boxsp box, integer n, segmentst s, pointst p)
	This function takes a segment and a box as parameters and returns the part of the segment that resides within the box. Just as atinstant() method the function returns three columns (n, s, p) where n informs whether the result is a point (value 1) or a segment (value 2) or there is no intersection between the segment and the box (value 0). Especially for values 1 and 2 of property “n”, “p” gets the point and “s” gets the segment, respectively. More...

void	atbox (segmentst segment, boxst box, integer n, segmentst s, pointst p)
	This function takes a segment and a box as parameters and returns the part of the segment that resides within the box. Just as atinstant() method the function returns three columns (n, s, p) where n informs whether the result is a point (value 1) or a segment (value 2) or there is no intersection between the segment and the box (value 0). Especially for values 1 and 2 of property “n”, “p” gets the point and “s” gets the segment, respectively. More...

pointst	intersectionpoint (segmentst segmenta, segmentst segmentb)

Detailed Description

File containing the implementation of the SegmentST data type.

Author: Marios Vodas (mvoda.nosp@m.s@gm.nosp@m.ail.c.nosp@m.om).

See also: SegmentST; Spatio-temporal data types

Function Documentation

void atbox	(	segmentst	segment,
		boxsp	box,
		integer	n,
		segmentst	s,
		pointst	p
	)

This function takes a segment and a box as parameters and returns the part of the segment that resides within the box. Just as atinstant() method the function returns three columns (n, s, p) where n informs whether the result is a point (value 1) or a segment (value 2) or there is no intersection between the segment and the box (value 0). Especially for values 1 and 2 of property “n”, “p” gets the point and “s” gets the segment, respectively.

Parameters

[in]	segment	the segment
[in]	box	the box
[out]	n	informs whether the result is a point
[out]	p	the point
[out]	s	the segment

Returns: the part of the segment

See also: At box

void atbox	(	segmentst	segment,
		boxst	box,
		integer	n,
		segmentst	s,
		pointst	p
	)

This function takes a segment and a box as parameters and returns the part of the segment that resides within the box. Just as atinstant() method the function returns three columns (n, s, p) where n informs whether the result is a point (value 1) or a segment (value 2) or there is no intersection between the segment and the box (value 0). Especially for values 1 and 2 of property “n”, “p” gets the point and “s” gets the segment, respectively.

Parameters

[in]	segment	the segment
[in]	box	the box
[out]	n	informs whether the result is a point
[out]	p	the point
[out]	s	the segment

Returns: the part of the segment

See also: At box

void atboxt	(	segmentst	segment,
		boxsp	box,
		integer	n,
		period	p,
		timestamp	ts
	)

This function takes a segment and a box as parameters and returns the part of the segment that resides within the box. Just as atinstant() method the function returns three columns (n, s, p) where n informs whether the result is a point (value 1) or a segment (value 2) or there is no intersection between the segment and the box (value 0). Especially for values 1 and 2 of property “n”, “p” gets the point and “s” gets the segment, respectively.

Parameters

[in]	segment	the segment
[in]	box	the box
[out]	n	informs whether the result is a point
[out]	p	the point
[out]	s	the segment

Returns: the part of the segment

See also: At box

pointst atinstant	(	segmentst	segment,
		timestamp	ts,
		boolean	checkcontainment = `true`
	)

This function takes a segment and a timestamp as parameters and returns the point where the object was found at the given timestamp.

Parameters

[in] segment the segment

Returns: a PointST with the position of the interpolation

See also: atInstant

pointsp atinstantsp	(	segmentst	segment,
		timestamp	ts,
		boolean	checkcontainment = `true`
	)

This function takes a segment and a timestamp as parameters and returns the point where the object was found at the given timestamp.

Parameters

[in] segment the segment

Returns: a PointSP with the position of the interpolation

See also: atInstant

void atperiod	(	segmentst	segment,
		period	period,
		integer	n,
		segmentst	s,
		pointst	p
	)

This function takes a segment and a period as parameters and returns the part of the segment that corresponds to the given period. The segment might have only one timestamp in common with the period so in that case the function returns a point instead of a segment. This is why the function returns three columns (n, s, p) where n is the number of common points, s is the segment within the period (if n is 2) and p is the point that the segment was within the period (if n is 1).

Parameters

[in]	segment	the segment
[in]	period	the period
[out]	n	the number of common points
[out]	s	the segment within the period
[out]	p	the point that the segment was within the period

Returns: the part of the segment that corresponds to the given period

See also: At period

void atperiodsp	(	segmentst	segment,
		period	period,
		integer	n,
		segmentsp	s,
		pointsp	p
	)

This function takes a segment and a period as parameters and returns the part of the segment that corresponds to the given period. The segment might have only one timestamp in common with the period so in that case the function returns a point instead of a segment. This is why the function returns three columns (n, s, p) where n is the number of common points, s is the segment within the period (if n is 2) and p is the point that the segment was within the period (if n is 1).

Parameters

[in]	segment	the segment
[in]	ts	the period

Returns: the part of the segment that corresponds to the given period

See also: At period

pointst atpoint	(	segmentst	segment,
		pointsp	point,
		boolean	checkcontainment = `true`
	)

This function takes a segment and a point as parameters and returns the timestamp at which the object was found at the given point. The point has to be on the segment, otherwise the function returns NULL. The value “false” on the last parameter enforces it to avoid checking for containment. In contrast, if the value of the third parameter is set to “yes” then the cost of the calculation gets higher.

Parameters

[in]	segment	the segment
[in]	point	the point
[in]	checkContainment	check if the point is contained on the segment

Returns: a PointST with the timestamp of the interpolation

See also: atPoint

timestamp atpointt	(	segmentst	segment,
		pointsp	point,
		boolean	checkcontainment = `true`
	)

This function takes a segment and a point as parameters and returns the timestamp at which the object was found at the given point. The point has to be on the segment, otherwise the function returns NULL. The value “false” on the last parameter enforces it to avoid checking for containment. In contrast, if the value of the third parameter is set to “yes” then the cost of the calculation gets higher.

Parameters

[in]	segment	the segment
[in]	point	the point
[in]	checkContainment	check if the point is contained on the segment

Returns: the timestamp of the point

See also: atPoint

pointst intersectionpoint	(	segmentst	segmenta,
		segmentst	segmentb
	)

Functions

Detailed Description

Function Documentation