********************************************************************************

Changes that were made in July 2006 by Joshua Reich I.

********************************************************************************

Code Cleanup:

Update the calling convention for all external facing functions. By external

facing, I mean all functions that are directly referenced in cube.sql. Prior

to my update, all functions used the older V0 calling convention. They now

use V1.

New Functions:

cube(float[]), which makes a zero volume cube from a float array

cube(float[], float[]), which allows the user to create a cube from

two float arrays; one for the upper right and one for the lower left

coordinate.

cube_subset(cube, int4[]), to allow you to reorder or choose a subset of

dimensions from a cube, using index values specified in the array.

********************************************************************************

Changes that were made in August/September 2002 by Bruno Wolff III.

********************************************************************************

Note that this was based on a 7.3 development version and changes may not

directly work with earlier versions.

This makes a one dimensional cube.

cube(1,2) == '(1),(2)'

cube(float8[]) returns cube

This makes a zero-volume cube using the coordinates defined by the

array.

cube(ARRAY[1,2]) == '(1,2)'

cube(float8[], float8[]) returns cube

This makes a cube, with upper right and lower left coordinates as

defined by the 2 float arrays. Arrays must be of the same length.

cube('{1,2}'::float[], '{3,4}'::float[]) == '(1,2),(3,4)'

cube(cube, float8) returns cube

This builds a new cube by adding a dimension on to an existing cube with

the same values for both parts of the new coordinate. This is useful for

cube_ur_coord returns the nth coordinate value for the upper right corner

of a cube. This is useful for doing coordinate transformations.

cube_subset(cube, int[]) returns cube

Builds a new cube from an existing cube, using a list of dimension indexes

from an array. Can be used to find both the ll and ur coordinate of single

dimenion, e.g.: cube_subset(cube('(1,3,5),(6,7,8)'), ARRAY[2]) = '(3),(7)'

Or can be used to drop dimensions, or reorder them as desired, e.g.:

cube_subset(cube('(1,3,5),(6,7,8)'), ARRAY[3,2,1,1]) = '(5, 3, 1, 1),(8, 7, 6, 6)'

cube_is_point(cube) returns bool

cube_is_point returns true if a cube is also a point. This is true when the

two defining corners are the same.

These include changing the precision from single precision to double

precision and adding some new functions.

------------------------------------------------------------------------

Additional updates were made by Joshua Reich <josh@root.net> in July 2006.

These include cube(float8[], float8[]) and cleaning up the code to use

the V1 call protocol instead of the deprecated V0 form.