Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

tabledefinehypercolumn - Function

	Package	utility
	Module	table

define a hypercolumn in a table descriptor

Synopsis
tabledefinehypercolumn(tabledesc, name, ndim, datacolumns, coordcolumns, idcolumns)

Description
Defines a hypercolumn in the given table descriptor. A hypercolumn is an entity used by the Tiled Storage Managers (TSM). It defines which columns have to be stored together with a TSM.

Arguments

tabledesc	inout	Table descriptor
		Allowed:	Any valid table descriptor
name	in	Name of hypercolumn
		Allowed:	String
ndim	in	Dimensionality of hypercolumn
		Allowed:	Int
datacolumns	in	Data columns to be stored with TSM
		Allowed:	Vector of strings
coordcolumns	in	Coordinate columns to be stored with TSM
		Allowed:	Vector of strings
		Default:	none
idcolumns	in	Id columns to be stored with TSM
		Allowed:	Vector of strings
		Default:	none

Returns
Bool

Example

scd1:=tablecreatescalarcoldesc("col2","aa")
scd2:=tablecreatescalarcoldesc("col1",1,"IncrementalStMan")
scd3:=tablecreatescalarcoldesc("colrec1",[=])
acd1:=tablecreatearraycoldesc("arr1",1,0,[2,3,4])
acd2:=tablecreatearraycoldesc("arr2",as_complex(0))
td:=tablecreatedesc(scd1, scd2, scd3, acd1, acd2)
tabledefinehypercolumn(td, "TiledArray", 4, "arr1")
tab:=table("mytable", tabledesc=td, nrow=100)

This creates a table descriptor td from five column descriptors and then creates a 100-row table called mytable from the table descriptor.
The columns contain respectivily strings, integer scalars, records, 3D integer arrays with fixed shape [2,3,4], and complex arrays with variable shape. The first array is stored with the Tiled Storage Manager (in this case the TiledColumnStMan).

See Also
tablecreatedesc tablecreatescalardesc tablecreatearraydesc