MobilityDB 1.1
tnpoint_static.h
Go to the documentation of this file.
1/*****************************************************************************
2 *
3 * This MobilityDB code is provided under The PostgreSQL License.
4 * Copyright (c) 2016-2023, Université libre de Bruxelles and MobilityDB
5 * contributors
6 *
7 * MobilityDB includes portions of PostGIS version 3 source code released
8 * under the GNU General Public License (GPLv2 or later).
9 * Copyright (c) 2001-2023, PostGIS contributors
10 *
11 * Permission to use, copy, modify, and distribute this software and its
12 * documentation for any purpose, without fee, and without a written
13 * agreement is hereby granted, provided that the above copyright notice and
14 * this paragraph and the following two paragraphs appear in all copies.
15 *
16 * IN NO EVENT SHALL UNIVERSITE LIBRE DE BRUXELLES BE LIABLE TO ANY PARTY FOR
17 * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING
18 * LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION,
19 * EVEN IF UNIVERSITE LIBRE DE BRUXELLES HAS BEEN ADVISED OF THE POSSIBILITY
20 * OF SUCH DAMAGE.
21 *
22 * UNIVERSITE LIBRE DE BRUXELLES SPECIFICALLY DISCLAIMS ANY WARRANTIES,
23 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
24 * AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON
25 * AN "AS IS" BASIS, AND UNIVERSITE LIBRE DE BRUXELLES HAS NO OBLIGATIONS TO
26 * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. 
27 *
28 *****************************************************************************/
29
34#ifndef __TNPOINT_STATIC_H__
35#define __TNPOINT_STATIC_H__
36
37/* PostgreSQL */
38#include <postgres.h>
39/* MEOS */
40#include "npoint/tnpoint.h"
41
42/*****************************************************************************/
43
44/* General functions */
45
46extern int32_t get_srid_ways();
47extern GSERIALIZED *npointarr_geom(Npoint **points, int count);
48extern GSERIALIZED *nsegmentarr_geom(Nsegment **segments, int count);
49extern Nsegment **nsegmentarr_normalize(Nsegment **segments, int *count);
50
51/* Input/Output functions */
52
53extern Npoint *npoint_in(const char *str, bool end);
54extern char *npoint_out(const Npoint *np, int maxdd);
55
56/* Constructor functions */
57
58extern Npoint *npoint_make(int64 rid, double pos);
59extern void npoint_set(int64 rid, double pos, Npoint *np);
60extern Nsegment *nsegment_make(int64 rid, double pos1, double pos2);
61extern void nsegment_set(int64 rid, double pos1, double pos2, Nsegment *ns);
62
63/* Cast functions */
64
65extern Nsegment *npoint_to_nsegment(const Npoint *np);
66
67/* Input/output functions */
68
69extern Nsegment *nsegment_in(const char *str);
70extern char *nsegment_out(const Nsegment *ns, int maxdd);
71
72/* Accessor functions */
73
74extern int64 npoint_route(const Npoint *np);
75extern double npoint_position(const Npoint *np);
76extern int64 nsegment_route(const Nsegment *ns);
77extern double nsegment_start_position(const Nsegment *ns);
78extern double nsegment_end_position(const Nsegment *ns);
79
80/* Conversions between network and Euclidean space */
81
82extern bool route_exists(int64 rid);
83extern double route_length(int64 rid);
84extern GSERIALIZED *route_geom(int64 rid);
85extern GSERIALIZED *npoint_geom(const Npoint *np);
86extern Npoint *geom_npoint(const GSERIALIZED *gs);
87extern GSERIALIZED *nsegment_geom(const Nsegment *ns);
88extern Nsegment *geom_nsegment(const GSERIALIZED *gs);
89
90/* SRID functions */
91
92extern int npoint_srid(const Npoint *np);
93extern int nsegment_srid(const Nsegment *ns);
94
95/* Comparison functions */
96
97extern bool npoint_eq(const Npoint *np1, const Npoint *np2);
98extern bool npoint_ne(const Npoint *np1, const Npoint *np2);
99extern int npoint_cmp(const Npoint *np1, const Npoint *np2);
100extern bool npoint_lt(const Npoint *np1, const Npoint *np2);
101extern bool npoint_le(const Npoint *np1, const Npoint *np2);
102extern bool npoint_gt(const Npoint *np1, const Npoint *np2);
103extern bool npoint_ge(const Npoint *np1, const Npoint *np2);
104
105extern bool nsegment_eq(const Nsegment *ns1, const Nsegment *ns2);
106extern bool nsegment_ne(const Nsegment *ns1, const Nsegment *ns2);
107extern int nsegment_cmp(const Nsegment *ns1, const Nsegment *ns2);
108extern bool nsegment_lt(const Nsegment *ns1, const Nsegment *ns2);
109extern bool nsegment_le(const Nsegment *ns1, const Nsegment *ns2);
110extern bool nsegment_gt(const Nsegment *ns1, const Nsegment *ns2);
111extern bool nsegment_ge(const Nsegment *ns1, const Nsegment *ns2);
112
113/* Hash functions */
114
115extern uint32 npoint_hash(const Npoint *np);
116extern uint64 npoint_hash_extended(const Npoint *np, uint64 seed);
117
118/*****************************************************************************/
119
120#endif /* __TNPOINT_STATIC_H__ */
nsegment_ne
bool nsegment_ne(const Nsegment *ns1, const Nsegment *ns2)
Return true if the first network segment is not equal to the second one.
Definition: tnpoint_static.c:802
npointarr_geom
GSERIALIZED * npointarr_geom(Npoint **points, int count)
Convert a network point array into a geometry.
Definition: tnpoint_static.c:99
npoint_cmp
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,...
Definition: tnpoint_static.c:730
nsegment_in
Nsegment * nsegment_in(const char *str)
Return a network point from its string representation.
Definition: tnpoint_static.c:276
npoint_out
char * npoint_out(const Npoint *np, int maxdd)
Return the string representation of a network point.
Definition: tnpoint_static.c:260
npoint_hash
uint32 npoint_hash(const Npoint *np)
Return the 32-bit hash value of a network point.
Definition: tnpoint_static.c:885
npoint_set
void npoint_set(int64 rid, double pos, Npoint *np)
Set a network segment from the arguments.
Definition: tnpoint_static.c:316
geom_npoint
Npoint * geom_npoint(const GSERIALIZED *gs)
Transforms the geometry into a network point.
Definition: tnpoint_static.c:557
geom_nsegment
Nsegment * geom_nsegment(const GSERIALIZED *gs)
Transforms the geometry into a network segment.
Definition: tnpoint_static.c:618
nsegment_gt
bool nsegment_gt(const Nsegment *ns1, const Nsegment *ns2)
Return true if the first network segment is greater than the second one.
Definition: tnpoint_static.c:858
nsegment_set
void nsegment_set(int64 rid, double pos1, double pos2, Nsegment *ns)
Set a network segment from the arguments.
Definition: tnpoint_static.c:346
nsegment_srid
int nsegment_srid(const Nsegment *ns)
Return the SRID of the network segment.
Definition: tnpoint_static.c:693
route_length
double route_length(int64 rid)
Access the edge table to return the route length from the corresponding route identifier.
Definition: tnpoint_static.c:452
npoint_lt
bool npoint_lt(const Npoint *np1, const Npoint *np2)
Return true if the first network point is less than the second one.
Definition: tnpoint_static.c:748
npoint_ge
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.
Definition: tnpoint_static.c:780
nsegment_le
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.
Definition: tnpoint_static.c:848
npoint_position
double npoint_position(const Npoint *np)
Return the position of the network point.
Definition: tnpoint_static.c:388
nsegment_eq
bool nsegment_eq(const Nsegment *ns1, const Nsegment *ns2)
Return true if the first network segment is equal to the second one.
Definition: tnpoint_static.c:792
nsegment_geom
GSERIALIZED * nsegment_geom(const Nsegment *ns)
Transforms the network segment into a geometry.
Definition: tnpoint_static.c:602
npoint_geom
GSERIALIZED * npoint_geom(const Npoint *np)
Transforms the network point into a geometry.
Definition: tnpoint_static.c:545
nsegment_route
int64 nsegment_route(const Nsegment *ns)
Return the route of the network segment.
Definition: tnpoint_static.c:397
route_exists
bool route_exists(int64 rid)
Return true if the edge table contains a route with the route identifier.
Definition: tnpoint_static.c:428
npoint_in
Npoint * npoint_in(const char *str, bool end)
Return a network point from its string representation.
Definition: tnpoint_static.c:251
nsegmentarr_normalize
Nsegment ** nsegmentarr_normalize(Nsegment **segments, int *count)
Normalize the array of temporal segments.
Definition: tnpoint_static.c:200
npoint_make
Npoint * npoint_make(int64 rid, double pos)
Construct a network segment from the arguments.
Definition: tnpoint_static.c:304
npoint_to_nsegment
Nsegment * npoint_to_nsegment(const Npoint *np)
Cast a network point as a network segment.
Definition: tnpoint_static.c:366
nsegment_end_position
double nsegment_end_position(const Nsegment *ns)
Return the end position of the network segment.
Definition: tnpoint_static.c:415
nsegmentarr_geom
GSERIALIZED * nsegmentarr_geom(Nsegment **segments, int count)
Convert a network segment array into a geometry.
Definition: tnpoint_static.c:130
npoint_le
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.
Definition: tnpoint_static.c:759
npoint_srid
int npoint_srid(const Npoint *np)
Return the SRID of the network point.
Definition: tnpoint_static.c:681
npoint_hash_extended
uint64 npoint_hash_extended(const Npoint *np, uint64 seed)
Return the 32-bit hash value of a network point.
Definition: tnpoint_static.c:902
npoint_gt
bool npoint_gt(const Npoint *np1, const Npoint *np2)
Return true if the first network point is greater than the second one.
Definition: tnpoint_static.c:769
npoint_eq
bool npoint_eq(const Npoint *np1, const Npoint *np2)
Return true if the first network point is equal to the second one.
Definition: tnpoint_static.c:709
nsegment_cmp
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,...
Definition: tnpoint_static.c:814
npoint_ne
bool npoint_ne(const Npoint *np1, const Npoint *np2)
Return true if the first network point is not equal to the second one.
Definition: tnpoint_static.c:718
nsegment_lt
bool nsegment_lt(const Nsegment *ns1, const Nsegment *ns2)
Return true if the first network segment is less than the second one.
Definition: tnpoint_static.c:837
nsegment_out
char * nsegment_out(const Nsegment *ns, int maxdd)
Output function for network segments.
Definition: tnpoint_static.c:285
route_geom
GSERIALIZED * route_geom(int64 rid)
Access the edge table to get the route geometry from corresponding route identifier.
Definition: tnpoint_static.c:480
get_srid_ways
int32_t get_srid_ways()
Network-based static point/segments.
Definition: tnpoint_static.c:70
nsegment_start_position
double nsegment_start_position(const Nsegment *ns)
Return the start position of the network segment.
Definition: tnpoint_static.c:406
nsegment_make
Nsegment * nsegment_make(int64 rid, double pos1, double pos2)
Construct a network segment from the arguments.
Definition: tnpoint_static.c:334
nsegment_ge
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.
Definition: tnpoint_static.c:869
npoint_route
int64 npoint_route(const Npoint *np)
Return the route of the network point.
Definition: tnpoint_static.c:379
uint32
unsigned int uint32
Definition: pg_ext_defs.in.h:13
uint64
unsigned long int uint64
Definition: pg_ext_defs.in.h:14
int64
long int int64
Definition: pg_ext_defs.in.h:9
GSERIALIZED
Definition: postgis_ext_defs.in.h:139
Npoint
Functions for temporal network points.
Definition: tnpoint.h:50
Nsegment
Definition: tnpoint.h:58
Generated by doxygen 1.9.4