MobilityDB 1.3
Loading...
Searching...
No Matches
temporal_aggfuncs.h
Go to the documentation of this file.
1/*****************************************************************************
2 *
3 * This MobilityDB code is provided under The PostgreSQL License.
4 * Copyright (c) 2016-2025, 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-2025, 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 __TEMPORAL_AGGFUNCS_H__
35#define __TEMPORAL_AGGFUNCS_H__
36
37/* PostgreSQL */
38#include <postgres.h>
39/* MEOS */
40#include <meos.h>
41#include "temporal/temporal.h"
42
43/*****************************************************************************/
44
45extern Datum datum_min_int32(Datum l, Datum r);
46extern Datum datum_max_int32(Datum l, Datum r);
49extern Datum datum_sum_int32(Datum l, Datum r);
51extern Datum datum_min_text(Datum l, Datum r);
52extern Datum datum_max_text(Datum l, Datum r);
56
57/* Specific skiplist functions for temporal aggregations */
58
59extern int temporal_skiplist_common(SkipList *list, void **values, int count,
60 int *lower, int *upper, int update[SKIPLIST_MAXLEVEL]);
61extern void **temporal_skiplist_merge(void **spliced, int spliced_count,
62 void **values, int count, datum_func2 func, bool crossings, int *newcount,
63 void ***tofree, int *nfree);
64extern void temporal_skiplist_splice(SkipList *list, void **values, int count,
65 datum_func2 func, bool crossings);
66
67/* Generic aggregation functions */
68
69extern TInstant **tinstant_tagg(const TInstant **instants1, int count1,
70 const TInstant **instants2, int count2, datum_func2 func, int *newcount,
71 void ***tofree, int *nfree);
72extern TSequence **tsequence_tagg(const TSequence **sequences1, int count1,
73 const TSequence **sequences2, int count2, datum_func2 func,
74 bool crossings, int *newcount);
76 datum_func2 func, bool interpoint);
77extern SkipList *temporal_tagg_combinefn(SkipList *state1, SkipList *state2,
78 datum_func2 func, bool crossings);
79
81 datum_func2 func);
82extern TSequence *tinstant_tavg_finalfn(const TInstant **instants, int count);
83extern TSequenceSet *tsequence_tavg_finalfn(const TSequence **sequences, int count);
85extern Temporal **temporal_transform_tcount(const Temporal *temp, int *count);
86extern Temporal **temporal_transform_tagg(const Temporal *temp, int *count,
87 TInstant *(*func)(const TInstant *));
89 const TSequenceSet *ss, datum_func2 func, bool crossings);
91 datum_func2 func);
92
94 datum_func2, bool crossings);
95extern SkipList *temporal_tagg_combinefn(SkipList *state1, SkipList *state2,
96 datum_func2 func, bool crossings);
98 datum_func2 func, bool crossings, TInstant *(*transform)(const TInstant *));
99
100/*****************************************************************************/
101
102#endif
External API of the Mobility Engine Open Source (MEOS) library.
#define SKIPLIST_MAXLEVEL
Structure to represent skiplist elements.
Definition: meos_internal.h:682
Datum(* datum_func2)(Datum, Datum)
Definition: meos_internal.h:729
Datum transform(PG_FUNCTION_ARGS)
uintptr_t Datum
Definition: postgres_ext_defs.in.h:7
Structure to represent skiplists that keep the current state of an aggregation.
Definition: meos_internal.h:696
Structure to represent temporal values of instant subtype.
Definition: meos.h:185
Structure to represent temporal values of sequence set subtype.
Definition: meos.h:224
Structure to represent temporal values of sequence subtype.
Definition: meos.h:202
Structure to represent the common structure of temporal values of any temporal subtype.
Definition: meos.h:173
Definition: pgtz.h:42
Datum datum_min_float8(Datum l, Datum r)
Return the minimum value of the two arguments.
Definition: temporal_aggfuncs.c:91
TSequence * tinstant_tavg_finalfn(const TInstant **instants, int count)
Final function for temporal average aggregation of temporal instant values.
Definition: temporal_aggfuncs.c:1352
SkipList * temporal_tagg_transform_transfn(SkipList *state, const Temporal *temp, datum_func2 func, bool crossings, TInstant *(*transform)(const TInstant *))
Transition function for aggregating temporal values that require a transformation to each composing i...
Definition: temporal_aggfuncs.c:986
SkipList * tinstant_tagg_transfn(SkipList *state, const TInstant *inst, datum_func2 func)
Generic transition function for aggregating temporal values of instant subtype.
Definition: temporal_aggfuncs.c:714
void temporal_skiplist_splice(SkipList *list, void **values, int count, datum_func2 func, bool crossings)
Insert a new set of values to the skiplist while performing the aggregation between the new values th...
Definition: temporal_aggfuncs.c:365
Datum datum_sum_double4(Datum l, Datum r)
Return the sum of the two arguments.
Definition: temporal_aggfuncs.c:165
Datum datum_sum_int32(Datum l, Datum r)
Return the sum of the two arguments.
Definition: temporal_aggfuncs.c:127
Datum datum_sum_float8(Datum l, Datum r)
Return the sum of the two arguments.
Definition: temporal_aggfuncs.c:136
TInstant ** tinstant_tagg(const TInstant **instants1, int count1, const TInstant **instants2, int count2, datum_func2 func, int *newcount, void ***tofree, int *nfree)
Generic aggregate function for temporal instants.
Definition: temporal_aggfuncs.c:386
SkipList * temporal_tagg_combinefn(SkipList *state1, SkipList *state2, datum_func2 func, bool crossings)
Generic combine function for aggregating temporal values.
Definition: temporal_aggfuncs.c:822
TSequence ** tsequence_tagg(const TSequence **sequences1, int count1, const TSequence **sequences2, int count2, datum_func2 func, bool crossings, int *newcount)
Generic aggregate function for temporal sequences.
Definition: temporal_aggfuncs.c:610
Datum datum_max_float8(Datum l, Datum r)
Return the maximum value of the two arguments.
Definition: temporal_aggfuncs.c:100
Temporal ** temporal_transform_tcount(const Temporal *temp, int *count)
Transform a temporal value into a temporal integer value for performing temporal count aggregation (d...
Definition: temporal_aggfuncs.c:1146
Datum datum_max_int32(Datum l, Datum r)
Return the maximum value of the two arguments.
Definition: temporal_aggfuncs.c:82
Datum datum_sum_double3(Datum l, Datum r)
Return the sum of the two arguments.
Definition: temporal_aggfuncs.c:155
void ** temporal_skiplist_merge(void **spliced, int spliced_count, void **values, int count, datum_func2 func, bool crossings, int *newcount, void ***tofree, int *nfree)
Return the new values obtained by merging the segment of the list that overlaps with the new set of t...
Definition: temporal_aggfuncs.c:338
int temporal_skiplist_common(SkipList *list, void **values, int count, int *lower, int *upper, int update[SKIPLIST_MAXLEVEL])
Determine the segment of the list that overlaps with the new set of temporal values.
Definition: temporal_aggfuncs.c:250
SkipList * tsequenceset_tagg_transfn(SkipList *state, const TSequenceSet *ss, datum_func2 func, bool crossings)
Generic transition function for aggregating temporal values of sequence set subtype.
Definition: temporal_aggfuncs.c:774
SkipList * tdiscseq_tagg_transfn(SkipList *state, const TSequence *seq, datum_func2 func)
Generic transition function for aggregating temporal discrete sequence values.
Definition: temporal_aggfuncs.c:734
Datum datum_min_int32(Datum l, Datum r)
Temporal aggregate functions.
Definition: temporal_aggfuncs.c:73
Datum datum_min_text(Datum l, Datum r)
Return the minimum value of the two arguments.
Definition: temporal_aggfuncs.c:109
Datum datum_sum_double2(Datum l, Datum r)
Return the sum of the two arguments.
Definition: temporal_aggfuncs.c:145
Temporal ** temporal_transform_tagg(const Temporal *temp, int *count, TInstant *(*func)(const TInstant *))
Transform a temporal value for aggregation.
Definition: temporal_aggfuncs.c:936
SkipList * temporal_tagg_transfn(SkipList *state, const Temporal *temp, datum_func2, bool crossings)
Generic transition function for aggregating temporal values of sequence set subtype.
Definition: temporal_aggfuncs.c:795
TSequenceSet * tsequence_tavg_finalfn(const TSequence **sequences, int count)
Final function for temporal average aggregation of temporal sequence values.
Definition: temporal_aggfuncs.c:1371
SkipList * tcontseq_tagg_transfn(SkipList *state, const TSequence *seq, datum_func2 func, bool interpoint)
Generic transition function for aggregating temporal values of sequence subtype.
Definition: temporal_aggfuncs.c:755
TInstant * tnumberinst_transform_tavg(const TInstant *inst)
Transform a temporal number into a temporal double2 value for performing temporal average aggregation...
Definition: temporal_aggfuncs.c:1339
Datum datum_max_text(Datum l, Datum r)
Return the maximum value of the two arguments.
Definition: temporal_aggfuncs.c:118