meos_npoint.h File Reference

#include <stdbool.h>
#include <stdint.h>
#include <meos.h>
#include <meos_geo.h>
#include <meos_internal.h>

Go to the source code of this file.

Data Structures
struct	Npoint
	API of the Mobility Engine Open Source (MEOS) library. More...
struct	Nsegment

Macros
#define	VALIDATE_NPOINTSET(set, ret)
	Macro for ensuring that the set passed as argument is a network point set. More...
#define	VALIDATE_TNPOINT(temp, ret)
	Macro for ensuring that the temporal value passed as argument is a temporal network point. More...

Functions
int	always_eq_npoint_tnpoint (const Npoint *np, const Temporal *temp)
	Return true if a network point is always equal to a temporal network point. More...
int	always_eq_tnpoint_npoint (const Temporal *temp, const Npoint *np)
	Return true if a temporal network point is always equal to a network point. More...
int	always_eq_tnpoint_tnpoint (const Temporal *temp1, const Temporal *temp2)
	Return true if two temporal network points are always equal. More...
int	always_ne_npoint_tnpoint (const Npoint *np, const Temporal *temp)
	Return true if a network point is always different from a temporal network point. More...
int	always_ne_tnpoint_npoint (const Temporal *temp, const Npoint *np)
	Return true if a temporal network point is always different from a network point. More...
int	always_ne_tnpoint_tnpoint (const Temporal *temp1, const Temporal *temp2)
	Return true if two temporal network points are always different. More...
bool	contained_npoint_set (const Npoint *np, const Set *s)
	Return true if a network point is contained in a set. More...
bool	contains_set_npoint (const Set *s, Npoint *np)
	Return true if a set contains a network point. More...
Temporal *	distance_tnpoint_npoint (const Temporal *temp, const Npoint *np)
	Return the temporal distance between a temporal network point and a network point. More...
Temporal *	distance_tnpoint_point (const Temporal *temp, const GSERIALIZED *gs)
	Return the temporal distance between a geometry point and a temporal network point @csqlfn Distance_tnpoint_point() More...
Temporal *	distance_tnpoint_tnpoint (const Temporal *temp1, const Temporal *temp2)
	Return the temporal distance between two temporal network points. More...
int	ever_eq_npoint_tnpoint (const Npoint *np, const Temporal *temp)
	Return true if a network point is ever equal to a temporal network point. More...
int	ever_eq_tnpoint_npoint (const Temporal *temp, const Npoint *np)
	Return true if a temporal network point is ever equal to a network point. More...
int	ever_eq_tnpoint_tnpoint (const Temporal *temp1, const Temporal *temp2)
	Return true if two temporal network points are ever equal. More...
int	ever_ne_npoint_tnpoint (const Npoint *np, const Temporal *temp)
	Return true if a network point is ever different from a temporal network point. More...
int	ever_ne_tnpoint_npoint (const Temporal *temp, const Npoint *np)
	Return true if a temporal network point is ever different from a network point. More...
int	ever_ne_tnpoint_tnpoint (const Temporal *temp1, const Temporal *temp2)
	Return true if two temporal network points are ever different. More...
Npoint *	geom_to_npoint (const GSERIALIZED *gs)
	Transform a geometry into a network point. More...
Nsegment *	geom_to_nsegment (const GSERIALIZED *gs)
	Transform a geometry into a network segment. More...
int32_t	get_srid_ways (void)
	Return the SRID of the routes in the ways table. More...
Set *	intersection_npoint_set (const Npoint *np, const Set *s)
	Return the intersection of a network point and a set. More...
Set *	intersection_set_npoint (const Set *s, const Npoint *np)
	Return the intersection of a set and a network point. More...
Set *	minus_npoint_set (const Npoint *np, const Set *s)
	Return the difference of a network point and a set. More...
Set *	minus_set_npoint (const Set *s, const Npoint *np)
	Return the difference of a set and a network point. More...
double	nad_tnpoint_geo (const Temporal *temp, const GSERIALIZED *gs)
	Return the nearest approach distance of a temporal network point and a geometry. More...
double	nad_tnpoint_npoint (const Temporal *temp, const Npoint *np)
	Return the nearest approach distance of a temporal network point and a network point. More...
double	nad_tnpoint_stbox (const Temporal *temp, const STBox *box)
	Return the nearest approach distance of a temporal network point and a spatiotemporal box. More...
double	nad_tnpoint_tnpoint (const Temporal *temp1, const Temporal *temp2)
	Return the nearest approach distance of two temporal network points. More...
TInstant *	nai_tnpoint_geo (const Temporal *temp, const GSERIALIZED *gs)
	Return the nearest approach instant of the temporal network point and a geometry. More...
TInstant *	nai_tnpoint_npoint (const Temporal *temp, const Npoint *np)
	Return the nearest approach instant of the network point and a temporal network point. More...
TInstant *	nai_tnpoint_tnpoint (const Temporal *temp1, const Temporal *temp2)
	Return the nearest approach instant of two temporal network points. More...
char *	npoint_as_ewkt (const Npoint *np, int maxdd)
	Return the Extended Well-Known Text (EWKT) representation of a network point. More...
char *	npoint_as_hexwkb (const Npoint *np, uint8_t variant, size_t *size_out)
	Return the ASCII hex-encoded Well-Known Binary (HexWKB) representation of a network point. More...
char *	npoint_as_text (const Npoint *np, int maxdd)
	Return the Well-Known Text (WKT) representation of a network point. More...
uint8_t *	npoint_as_wkb (const Npoint *np, uint8_t variant, size_t *size_out)
	Return the Well-Known Binary (WKB) representation of a circular buffer. More...
int	npoint_cmp (const Npoint *np1, const Npoint *np2)
	Return -1, 0, or 1 depending on whether the first network point is less than, equal to, or greater than the second one. More...
bool	npoint_eq (const Npoint *np1, const Npoint *np2)
	Return true if the first network point is equal to the second one. More...
Npoint *	npoint_from_hexwkb (const char *hexwkb)
	Return a network point from its ASCII hex-encoded Well-Known Binary (WKB) representation. More...
Npoint *	npoint_from_wkb (const uint8_t *wkb, size_t size)
	Return a network point from its Well-Known Binary (WKB) representation. More...
bool	npoint_ge (const Npoint *np1, const Npoint *np2)
	Return true if the first network point is greater than or equal to the second one. More...
bool	npoint_gt (const Npoint *np1, const Npoint *np2)
	Return true if the first network point is greater than the second one. More...
uint32	npoint_hash (const Npoint *np)
	Return the 32-bit hash value of a network point. More...
uint64	npoint_hash_extended (const Npoint *np, uint64 seed)
	Return the 64-bit hash value of a network point using a seed. More...
Npoint *	npoint_in (const char *str)
	Return a network point from its string representation. More...
bool	npoint_le (const Npoint *np1, const Npoint *np2)
	Return true if the first network point is less than or equal to the second one. More...
bool	npoint_lt (const Npoint *np1, const Npoint *np2)
	Return true if the first network point is less than the second one. More...
Npoint *	npoint_make (int64 rid, double pos)
	Return a network point from a route identifier and a position. More...
bool	npoint_ne (const Npoint *np1, const Npoint *np2)
	Return true if the first network point is not equal to the second one. More...
char *	npoint_out (const Npoint *np, int maxdd)
	Return the string representation of a network point. More...
double	npoint_position (const Npoint *np)
	Return the position of a network point. More...
Npoint *	npoint_round (const Npoint *np, int maxdd)
	Return a network point with the precision of the position set to a number of decimal places. More...
int64	npoint_route (const Npoint *np)
	Return the route of a network point. More...
bool	npoint_same (const Npoint *np1, const Npoint *np2)
	Return true if two network points are approximately equal with respect to an epsilon value. More...
int32_t	npoint_srid (const Npoint *np)
STBox *	npoint_timestamptz_to_stbox (const Npoint *np, TimestampTz t)
	Return a spatiotemporal box constructed from a network point and a timestamptz. More...
GSERIALIZED *	npoint_to_geom (const Npoint *np)
	Transform a network point into a geometry. More...
Nsegment *	npoint_to_nsegment (const Npoint *np)
	Convert a network point into a network segment. More...
Set *	npoint_to_set (const Npoint *np)
	Convert a network point into a network point set. More...
STBox *	npoint_to_stbox (const Npoint *np)
	Convert a network point into a spatiotemporal box. More...
STBox *	npoint_tstzspan_to_stbox (const Npoint *np, const Span *s)
	Return a spatiotemporal box constructed from a network point and a timestamptz. More...
Set *	npoint_union_transfn (Set *state, const Npoint *np)
	Transition function for set union aggregate of network points. More...
Npoint *	npointset_end_value (const Set *s)
	Return a copy of the end value of a network point set. More...
Set *	npointset_in (const char *str)
	Return a set from its Well-Known Text (WKT) representation. More...
Set *	npointset_make (const Npoint **values, int count)
	Return a network point set from an array of values. More...
char *	npointset_out (const Set *s, int maxdd)
	Return the string representation of a network point set. More...
Set *	npointset_routes (const Set *s)
	Return the routes of a network point set. More...
Npoint *	npointset_start_value (const Set *s)
	Return a copy of the start value of a network point set. More...
bool	npointset_value_n (const Set *s, int n, Npoint **result)
	Return in the last argument a copy of the n-th value of a circular buffer set. More...
Npoint **	npointset_values (const Set *s)
	Return the array of copies of the values of a network point set. More...
int	nsegment_cmp (const Nsegment *ns1, const Nsegment *ns2)
	Return -1, 0, or 1 depending on whether the first network segment is less than, equal to, or greater than the second one. More...
double	nsegment_end_position (const Nsegment *ns)
	Return the end position of a network segment. More...
bool	nsegment_eq (const Nsegment *ns1, const Nsegment *ns2)
	Return true if the first network segment is equal to the second one. More...
bool	nsegment_ge (const Nsegment *ns1, const Nsegment *ns2)
	Return true if the first network segment is greater than or equal to the second one. More...
bool	nsegment_gt (const Nsegment *ns1, const Nsegment *ns2)
	Return true if the first network segment is greater than the second one. More...
Nsegment *	nsegment_in (const char *str)
	Return a network point from its string representation. More...
bool	nsegment_le (const Nsegment *ns1, const Nsegment *ns2)
	Return true if the first network segment is less than or equal to the second one. More...
bool	nsegment_lt (const Nsegment *ns1, const Nsegment *ns2)
	Return true if the first network segment is less than the second one. More...
Nsegment *	nsegment_make (int64 rid, double pos1, double pos2)
	Return a network segment from a route identifier and two positions. More...
bool	nsegment_ne (const Nsegment *ns1, const Nsegment *ns2)
	Return true if the first network segment is not equal to the second one. More...
char *	nsegment_out (const Nsegment *ns, int maxdd)
	Return the string representation of a network segment. More...
Nsegment *	nsegment_round (const Nsegment *ns, int maxdd)
	Return a network segment with the precision of the positions set to a number of decimal places. More...
int64	nsegment_route (const Nsegment *ns)
	Return the route of a network segment. More...
int32_t	nsegment_srid (const Nsegment *ns)
double	nsegment_start_position (const Nsegment *ns)
	Return the start position of a network segment. More...
GSERIALIZED *	nsegment_to_geom (const Nsegment *ns)
	Transform a network segment into a geometry. More...
STBox *	nsegment_to_stbox (const Nsegment *np)
	Convert a network segment into a spatiotemporal box. More...
bool	route_exists (int64 rid)
	Return true if the edge table contains a route with the route identifier. More...
GSERIALIZED *	route_geom (int64 rid)
	Access the edge table to get the route geometry from corresponding route identifier. More...
double	route_length (int64 rid)
	Access the edge table to return the route length from the corresponding route identifier. More...
GSERIALIZED *	shortestline_tnpoint_geo (const Temporal *temp, const GSERIALIZED *gs)
	Return the line connecting the nearest approach point between a geometry and a temporal network point. More...
GSERIALIZED *	shortestline_tnpoint_npoint (const Temporal *temp, const Npoint *np)
	Return the line connecting the nearest approach point between a network point and a temporal network point. More...
GSERIALIZED *	shortestline_tnpoint_tnpoint (const Temporal *temp1, const Temporal *temp2)
	Return the line connecting the nearest approach point between two temporal networks. More...
Temporal *	teq_tnpoint_npoint (const Temporal *temp, const Npoint *np)
	Return the temporal equality of a temporal network point and a network point. More...
Temporal *	tgeompoint_to_tnpoint (const Temporal *temp)
	Convert a temporal geometry point into a temporal network point. More...
Temporal *	tne_tnpoint_npoint (const Temporal *temp, const Npoint *np)
	Return the temporal inequality of a temporal network point and a network point. More...
Temporal *	tnpoint_at_geom (const Temporal *temp, const GSERIALIZED *gs)
	Return a temporal network point restricted to a geometry. More...
Temporal *	tnpoint_at_npoint (const Temporal *temp, const Npoint *np)
	Restrict a temporal network point to a network point. More...
Temporal *	tnpoint_at_npointset (const Temporal *temp, const Set *s)
	Restrict a temporal network point to a set of network points. More...
Temporal *	tnpoint_at_stbox (const Temporal *temp, const STBox *box, bool border_inc)
	Return a temporal network point restricted to a geometry. More...
Temporal *	tnpoint_cumulative_length (const Temporal *temp)
	Cumulative length traversed by a temporal network point. More...
Temporal *	tnpoint_in (const char *str)
	Return a temporal network point from its Well-Known Text (WKT) representation. More...
double	tnpoint_length (const Temporal *temp)
	Length traversed by a temporal network point. More...
Temporal *	tnpoint_minus_geom (const Temporal *temp, const GSERIALIZED *gs)
	Return a temporal point restricted to (the complement of) a geometry. More...
Temporal *	tnpoint_minus_npoint (const Temporal *temp, const Npoint *np)
	Restrict a temporal network point to the complement of a network point. More...
Temporal *	tnpoint_minus_npointset (const Temporal *temp, const Set *s)
	Restrict a temporal network point to the complement of a set of network points. More...
Temporal *	tnpoint_minus_stbox (const Temporal *temp, const STBox *box, bool border_inc)
	Return a temporal point restricted to (the complement of) a geometry. More...
char *	tnpoint_out (const Temporal *temp, int maxdd)
	Return the Well-Known Text (WKT) representation of a temporal network point. More...
Nsegment **	tnpoint_positions (const Temporal *temp, int *count)
	Return the network segments covered by the temporal network point @csqlfn Tnpoint_positions() More...
int64	tnpoint_route (const Temporal *temp)
	Return the single route of a temporal network point. More...
Set *	tnpoint_routes (const Temporal *temp)
	Return the array of routes of a temporal network point @csqlfn Tnpoint_routes() More...
Temporal *	tnpoint_speed (const Temporal *temp)
	Speed of a temporal network point. More...
SkipList *	tnpoint_tcentroid_transfn (SkipList *state, Temporal *temp)
	Transition function for temporal centroid aggregation of temporal network points. More...
Temporal *	tnpoint_to_tgeompoint (const Temporal *temp)
	Convert a temporal network point into a temporal geometry point. More...
GSERIALIZED *	tnpoint_trajectory (const Temporal *temp)
	Return the geometry covered by a temporal network point. More...
GSERIALIZED *	tnpoint_twcentroid (const Temporal *temp)
	Return the time-weighed centroid of a temporal network point. More...
Set *	union_npoint_set (const Npoint *np, const Set *s)
	Return the union of a network point and a set. More...
Set *	union_set_npoint (const Set *s, const Npoint *np)
	Return the union of a set and a network point. More...