npoint.c File Reference

Network-based static point and segment types. More...

#include "npoint/tnpoint.h"
#include <assert.h>
#include <float.h>
#include <limits.h>
#include <postgres.h>
#include <liblwgeom.h>
#include <meos.h>
#include <meos_geo.h>
#include <meos_npoint.h>
#include <meos_internal.h>
#include <meos_internal_geo.h>
#include "temporal/postgres_types.h"
#include "temporal/span.h"
#include "temporal/tsequence.h"
#include "temporal/type_inout.h"
#include "temporal/type_parser.h"
#include "temporal/type_util.h"
#include "geo/postgis_funcs.h"
#include "geo/tgeo.h"
#include "geo/tgeo_spatialfuncs.h"
#include "geo/tspatial_parser.h"
#include "npoint/tnpoint_parser.h"

Data Structures
struct	ways_record

Macros
#define	MAX_LENGTH_GEOM   100001
#define	NPOINT_MAXLEN   128
	Buffer size for input and output of npoint and nsegment values. More...
#define	NSEGMENT_MAXLEN   128
#define	SQL_MAXLEN   1024
#define	SQL_ROUTE_MAXLEN   64
#define	WAYS_CSV   "/usr/local/share/ways.csv"

Functions
Datum	datum_npoint_round (Datum npoint, Datum size)
	Return a network point with the precision of the position set to a number of decimal places. More...
bool	ensure_route_exists (int64 rid)
	Ensure that a route exists in the ways table. More...
bool	ensure_valid_position (double pos)
	Ensure valid position. 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 ()
	Return the SRID of the routes in the ways table. 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_collinear (const Npoint *np1, const Npoint *np2, const Npoint *np3, double ratio)
	Return true if the three values are collinear. 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...
Npoint *	npoint_parse (const char **str, bool end)
	Parse a network point from its string representation. 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...
void	npoint_set (int64 rid, double pos, Npoint *np)
	Return in the last argument a network point constructed from a route identifier and a position. More...
bool	npoint_set_stbox (const Npoint *np, STBox *box)
	Return in the last argument the spatiotemporal box of a network point. More...
int32_t	npoint_srid (const Npoint *np UNUSED)
	Return the SRID of a network point. More...
bool	npoint_timestamptz_set_stbox (const Npoint *np, TimestampTz t, STBox *box)
	Return in the last argument a spatiotemporal box constructed from a network point and a timestamptz. More...
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...
STBox *	npoint_to_stbox (const Npoint *np)
	Convert a network point into a spatiotemporal box. More...
bool	npoint_tstzspan_set_stbox (const Npoint *np, const Span *s, STBox *box)
	Return in the last argument a spatiotemporal box constructed from a network point and a timestamptz span. 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...
char *	npoint_wkt_out (Datum value, int maxdd)
	Output a network point in the Well-Known Text (WKT) representation (internal function) More...
GSERIALIZED *	npointarr_geom (Npoint **points, int count)
	Return a geometry converted from an array of network points. More...
void	npointarr_set_stbox (const Datum *values, int count, STBox *box)
	Return in the last argument a spatiotemporal box constructed from an array of network points. 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_parse (const char **str)
	Parse a network segment from its string representation. 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...
void	nsegment_set (int64 rid, double pos1, double pos2, Nsegment *ns)
	Return in the last argument a network segment constructed from a route identifier and two positions. More...
bool	nsegment_set_stbox (const Nsegment *ns, STBox *box)
	Return the bounding box of the network segment value. More...
static int	nsegment_sort_cmp (Nsegment **l, Nsegment **r)
	Comparator function for network segments. More...
int32_t	nsegment_srid (const Nsegment *ns UNUSED)
	Return the SRID of a network segment. More...
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 *ns)
	Convert a network segment into a spatiotemporal box. More...
GSERIALIZED *	nsegmentarr_geom (Nsegment **segments, int count)
	Return a geometry converted from an array of network segments. More...
Nsegment **	nsegmentarr_normalize (Nsegment **segments, int *count)
	Normalize an array of temporal segments. More...
static void	nsegmentarr_sort (Nsegment **segments, int count)
	Sort function for network segments. 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...

Variables
static int32_t	SRID_WAYS = SRID_INVALID

Detailed Description

Network-based static point and segment types.