10.11.2012 Views

Reference Manual of the nadc-tools API and Libraries - SRON

Reference Manual of the nadc-tools API and Libraries - SRON

Reference Manual of the nadc-tools API and Libraries - SRON

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

2.30 NADC PYTABLE <strong>API</strong><br />

Identifier NADC PYTABLE <strong>API</strong><br />

Author R.M. van Hees<br />

Language ANSI C<br />

Purpose subroutines to easily create/write/read attributes <strong>and</strong> datasets<br />

Returns status: negative value is returned on failure<br />

Comment none<br />

2.30.1 PYTABLE open file<br />

Identifier PYTABLE open file<br />

Purpose Open/Create a PyTable file<br />

Usage grpID = PYTABLE open file( filename, title );<br />

Input char filename[] : file name<br />

char title[] : title <strong>of</strong> <strong>the</strong> PyTable database<br />

Returns A negative value is returned on failure.<br />

Comment none<br />

2.30.2 PYTABLE open group<br />

Identifier PYTABLE open group<br />

Purpose Open/Create a group in an exsisting HDF5-file<br />

Usage grpID = PYTABLE open group( locID, name, sz hint );<br />

Input hid t locID : HDF5 object id<br />

char name[] : name <strong>of</strong> <strong>the</strong> group<br />

Returns A negative value is returned on failure.<br />

Comment none<br />

2.30.3 PYTABLE make array<br />

Identifier PYTABLE make array<br />

Purpose create extensible HDF5 dataset<br />

Usage stat = PYTABLE make array( locID, dset name, title, rank, dims,<br />

extdim, typeID, dims chunk, fill data,<br />

compress, shuffle, fletcher32, buff );<br />

Input hid t locID : HDF5 identifier <strong>of</strong> file or group<br />

char *dset name : name <strong>of</strong> dataset<br />

char *title :<br />

int rank : number <strong>of</strong> dimensions<br />

hsize t *dims : size <strong>of</strong> each dimension<br />

int extdim : index <strong>of</strong> expendable dimension<br />

hid t typeID : data type (HDF5 identifier)<br />

hsize t *dims chunk : chunk sizes<br />

void *fill data : Fill value for data<br />

unsigned int compress : compression level (zero for no compression)<br />

bool shuffle : shuffel data for better compression<br />

bool fletcher32 :<br />

void *buffer : buffer with data to write (or NULL)<br />

Returns A negative value is returned on failure.<br />

Comment none<br />

48

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!