FiberBundleHDF5
$Id: FiberHDF5.dfg,v 1.8 2006/12/12 12:32:50 werner Exp $
|
Data Structures | |
struct | _TimeTableEntry |
Typedefs | |
typedef struct _TimeTableEntry | TimeTableEntry |
Functions | |
F5_API hid_t | F5Bcreate_timetable_type (void) |
F5_API hsize_t | F5Bappend_timetable (hid_t loc_id, hid_t timetable_type_location_id, const TimeTableEntry *TTE, hsize_t append_dims) |
F5_API hsize_t | F5Bget_timetable_size (hid_t loc_id) |
hsize_t | F5Bread_timetable (hid_t loc_id, TimeTableEntry *TTE, hsize_t table_size) |
F5_API F5_TimeParameter * | F5BnewTimeParameter (void) |
F5_API void | F5deleteTimeParameter (F5_TimeParameter **) |
F5_API int | F5setTimeUnit (hid_t file_id, const F5_TimeParameter *) |
F5_API int | F5getTimeUnit (hid_t file_id, F5_TimeParameter *) |
F5_API hid_t | F5Bappend_timeslice (hid_t file_id, const F5_TimeParameter *time) |
F5_API hid_t | F5Bappend_slice (hid_t file_id, const double *time) |
F5_API F5Path * | F5Binitialize_path (hid_t File_id) |
F5_API hid_t | F5BgetMostRecentSlice (double *t, hid_t FileID, const char **time_attrib_names) |
F5_API hid_t | F5BgetMostRecentFileSlice (double t, const char *filename) |
F5_API hid_t | F5BgetGridVertexData (hid_t SliceID, const char *gridname, const char *chartname, const char *fieldname) |
typedef struct _TimeTableEntry TimeTableEntry |
Data type entry for time tables.
F5_API hid_t F5Bappend_slice | ( | hid_t | file_id, |
const double * | time | ||
) |
Get the HDF5 identifier for a given time slice. A new group is created in the file if none exists yet.
file_id | HDF5 File identifier. |
time | The time is specified as a pointer, such that it may be NULL to indicate a static dataset. |
Maybe move to another header.
Add consistency check on re-open of an existing group
References F5Gappend().
Referenced by F5Bappend_timeslice(), and F5LTcreateV().
F5_API hid_t F5Bappend_timeslice | ( | hid_t | file_id, |
const F5_TimeParameter * | time | ||
) |
Append a time slice in the given time unit. Only one time unit is allowed per file. If another time unit has already been defined in the file, the function will return without touching the file.
References F5Bappend_slice(), and _F5_TimeParameter::value.
F5_API hsize_t F5Bappend_timetable | ( | hid_t | loc_id, |
hid_t | timetable_type_location_id, | ||
const TimeTableEntry * | TTE, | ||
hsize_t | append_dims | ||
) |
Initialize a time table for the given location.
timetable_type_id | The type for time table entries, such as provided by F5Bcreate_timetable_type(), but it may well be (and should be) a named type instead of a transient type. |
Append entries to the time table associated with a certain location.
timetable_type_location_id | the location ID where the named datatype for timetable entries will be stored, in case it needs to be created. |
References F5Bcreate_timetable_type().
F5_API hid_t F5Bcreate_timetable_type | ( | void | ) |
Create a transient type that is compatible with the TimeTableEntry data structure. It must be release via H5Tclose() by the calling code.
Referenced by F5Bappend_timetable(), and F5Bread_timetable().
F5_API hsize_t F5Bget_timetable_size | ( | hid_t | loc_id | ) |
Get the number of entries in the respective time table.
F5_API hid_t F5BgetGridVertexData | ( | hid_t | SliceID, |
const char * | gridname, | ||
const char * | chartname, | ||
const char * | fieldname | ||
) |
Get the GridVertexData for given grid-, chart- and fieldnames.
F5_API hid_t F5BgetMostRecentFileSlice | ( | double | t, |
const char * | filename | ||
) |
Get the MostRecentSlice out of a HDF5 file with the given name.
References F5BgetMostRecentSlice().
F5_API hid_t F5BgetMostRecentSlice | ( | double * | t, |
hid_t | FileID, | ||
const char ** | time_attrib_names | ||
) |
Get the next slice for given time attriute names.
Referenced by F5BgetMostRecentFileSlice().
F5_API F5Path* F5Binitialize_path | ( | hid_t | File_id | ) |
Initialize an F5Path from a file for reading. The coordinate system is set to the default cartesian coordinates. No timeslice, grid, field etc. ID's are defined yet, these need to be filled in by iteration. This function is called internally by F5iterate_timeslices() for creating an F5Path object that is then modified to contain a valid group ID for each timeslice, grid, field, ... Currently, it is hard-coded for reading cartesian coordinates only. The preferred way is to employ iterators on reading files.
References ChartDomain_IDs::domain_name, and F5B_standard_cartesian_chart3D().
Referenced by F5iterate_timeslices().
F5_API F5_TimeParameter* F5BnewTimeParameter | ( | void | ) |
Allocate a new F5_TimeParameter structure in memory. Actually, one could also pass a static structure, but using this function and F5deleteTimePArameter(), the call is safe even if the TimeParameter structure is changed in a future version of F5.
hsize_t F5Bread_timetable | ( | hid_t | loc_id, |
TimeTableEntry * | TTE, | ||
hsize_t | table_size | ||
) |
Read the entries of a time table.
References F5Bcreate_timetable_type().
F5_API void F5deleteTimeParameter | ( | F5_TimeParameter ** | ) |
Deallocate a F5_TimeParameter structure from memory. It needs to be passed a pointer to a pointer, whereby the pointer is set to zero on deallocation. So it is safe to call this function multiple times on the same pointer (just for experimental convenience!).
F5_API int F5getTimeUnit | ( | hid_t | file_id, |
F5_TimeParameter * | |||
) |
Get the time unit information as specified in the file.
F5_API int F5setTimeUnit | ( | hid_t | file_id, |
const F5_TimeParameter * | TP | ||
) |
Set the time unit globally for the given file.