temporal_tile.h

Go to the documentation of this file.

/*****************************************************************************
 *
 * This MobilityDB code is provided under The PostgreSQL License.
 *
 * Copyright (c) 2016-2021, Université libre de Bruxelles and MobilityDB
 * contributors
 *
 * MobilityDB includes portions of PostGIS version 3 source code released
 * under the GNU General Public License (GPLv2 or later).
 * Copyright (c) 2001-2021, PostGIS contributors
 *
 * Permission to use, copy, modify, and distribute this software and its
 * documentation for any purpose, without fee, and without a written
 * agreement is hereby granted, provided that the above copyright notice and
 * this paragraph and the following two paragraphs appear in all copies.
 *
 * IN NO EVENT SHALL UNIVERSITE LIBRE DE BRUXELLES BE LIABLE TO ANY PARTY FOR
 * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING
 * LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION,
 * EVEN IF UNIVERSITE LIBRE DE BRUXELLES HAS BEEN ADVISED OF THE POSSIBILITY
 * OF SUCH DAMAGE.
 *
 * UNIVERSITE LIBRE DE BRUXELLES SPECIFICALLY DISCLAIMS ANY WARRANTIES,
 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
 * AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON
 * AN "AS IS" BASIS, AND UNIVERSITE LIBRE DE BRUXELLES HAS NO OBLIGATIONS TO
 * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. 
 *
 *****************************************************************************/

#ifndef __TEMPORAL_TILE_H__
#define __TEMPORAL_TILE_H__

#include <postgres.h>
#include <fmgr.h>

#include "temporal.h"

/*****************************************************************************/

typedef struct RangeBucketState
{
  bool done;
  int i;
  Oid basetypid;
  Temporal *temp; /* NULL when generating bucket list, used for splitting */
  Datum size;
  Datum origin;
  Datum minvalue;
  Datum maxvalue;
  Datum value;
} RangeBucketState;

typedef struct PeriodBucketState
{
  bool done;
  int i;
  int64 tunits;
  int64 torigin;
  TimestampTz mint;
  TimestampTz maxt;
  TimestampTz t;
} PeriodBucketState;

typedef struct TboxGridState
{
  bool done;
  int i;
  double xsize;
  int64 tunits;
  TBOX box;
  double value;
  TimestampTz t;
} TboxGridState;

/*****************************************************************************/

typedef struct ValueSplitState
{
  bool done;
  Datum size;
  Datum *buckets;
  Temporal **fragments;
  int i;
  int count;
} ValueSplitState;

typedef struct TimeSplitState
{
  bool done;
  int64 tunits;
  TimestampTz *buckets;
  Temporal **fragments;
  int i;
  int count;
} TimeSplitState;

typedef struct ValueTimeSplitState
{
  bool done;
  Datum *value_buckets;
  TimestampTz *time_buckets;
  Temporal **fragments;
  int i;
  int count;
} ValueTimeSplitState;

/*****************************************************************************/

extern double float_bucket_internal(double value, double size,
  double origin);
extern TimestampTz timestamptz_bucket_internal(TimestampTz timestamp,
  int64 tunits, TimestampTz torigin);
extern int64 get_interval_units(Interval *interval);

extern Datum number_bucket(PG_FUNCTION_ARGS);
extern Datum timestamptz_bucket(PG_FUNCTION_ARGS);
extern Datum range_bucket_list(PG_FUNCTION_ARGS);
extern Datum range_bucket(PG_FUNCTION_ARGS);
extern Datum period_bucket_list(PG_FUNCTION_ARGS);
extern Datum period_bucket(PG_FUNCTION_ARGS);
extern Datum tnumber_value_split(PG_FUNCTION_ARGS);
extern Datum temporal_time_split(PG_FUNCTION_ARGS);
extern Datum tbox_multidim_grid(PG_FUNCTION_ARGS);
extern Datum tbox_multidim_tile(PG_FUNCTION_ARGS);
extern Datum tnumber_value_time_split(PG_FUNCTION_ARGS);

#endif /* __TEMPORAL_TILE_H__ */

/*****************************************************************************/