Class H5
- java.lang.Object
-
- hdf.hdf5lib.H5
-
- All Implemented Interfaces:
java.io.Serializable
public class H5 extends java.lang.Object implements java.io.Serializable
This class is the Java interface for the HDF5 library.This code is the called by Java programs to access the entry points of the HDF5 library. Each routine wraps a single HDF5 entry point, generally with the arguments and return codes analogous to the C interface.
For details of the HDF5 library, see the HDF5 Documentation at: http://support.hdfgroup.org/HDF5/
Mapping of arguments for Java
In general, arguments to the HDF Java API are straightforward translations from the 'C' API described in the HDF Reference Manual.
HDF-5 C types to Java types HDF-5 Java H5T_NATIVE_INT int, Integer H5T_NATIVE_SHORT short, Short H5T_NATIVE_FLOAT float, Float H5T_NATIVE_DOUBLE double, Double H5T_NATIVE_CHAR byte, Byte H5T_C_S1 java.lang.String void *
(i.e., pointer to `Any')Special -- see HDFArray General Rules for Passing Arguments and Results In general, arguments passed IN to Java are the analogous basic types, as above. The exception is for arrays, which are discussed below.
The return value of Java methods is also the analogous type, as above. A major exception to that rule is that all HDF functions that return SUCCEED/FAIL are declared boolean in the Java version, rather than int as in the C. Functions that return a value or else FAIL are declared the equivalent to the C function. However, in most cases the Java method will raise an exception instead of returning an error code. See Errors and Exceptions below.
Java does not support pass by reference of arguments, so arguments that are returned through OUT parameters must be wrapped in an object or array. The Java API for HDF consistently wraps arguments in arrays.
For instance, a function that returns two integers is declared:
h_err_t HDF5dummy( int *a1, int *a2)
For the Java interface, this would be declared:public synchronized static native int HDF5dummy(int args[]);
where a1 is args[0] and a2 is args[1], and would be invoked:H5.HDF5dummy(a);
All the routines where this convention is used will have specific documentation of the details, given below.
HDF5 needs to read and write multi-dimensional arrays of any number type (and records). The HDF5 API describes the layout of the source and destination, and the data for the array passed as a block of bytes, for instance,
herr_t H5Dread(int fid, int filetype, int memtype, int memspace, void * data);
where ``void *'' means that the data may be any valid numeric type, and is a contiguous block of bytes that is the data for a multi-dimensional array. The other parameters describe the dimensions, rank, and datatype of the array on disk (source) and in memory (destination).
For Java, this ``ANY'' is a problem, as the type of data must always be declared. Furthermore, multidimensional arrays are definitely not layed out contiguously in memory. It would be infeasible to declare a separate routine for every combination of number type and dimensionality. For that reason, the HDFArray class is used to discover the type, shape, and size of the data array at run time, and to convert to and from a contiguous array of bytes in synchronized static native C order.
The upshot is that any Java array of numbers (either primitive or sub-classes of type Number) can be passed as an ``Object'', and the Java API will translate to and from the appropriate packed array of bytes needed by the C library. So the function above would be declared:
public synchronized static native int H5Dread(int fid, int filetype, int memtype, int memspace, Object data);
OPEN_IDS.addElement(id); and the parameter data can be any multi-dimensional array of numbers, such as float[][], or int[][][], or Double[][].The HDF-5 API defines a set of constants and enumerated values. Most of these values are available to Java programs via the class HDF5Constants. For example, the parameters for the h5open() call include two numeric values, HDFConstants.H5F_ACC_RDWR and HDF5Constants.H5P_DEFAULT. As would be expected, these numbers correspond to the C constants H5F_ACC_RDWR and H5P_DEFAULT.
The HDF-5 API defines a set of values that describe number types and sizes, such as "H5T_NATIVE_INT" and "hsize_t". These values are determined at run time by the HDF-5 C library. To support these parameters, the Java class HDF5CDataTypes looks up the values when initiated. The values can be accessed as public variables of the Java class, such as:
int data_type = HDF5CDataTypes.JH5T_NATIVE_INT;
The Java application uses both types of constants the same way, the only difference is that the HDF5CDataTypes may have different values on different platforms.The HDF5 error API (H5E) manages the behavior of the error stack in the HDF-5 library. This API is omitted from the JHI5. Errors are converted into Java exceptions. This is totally different from the C interface, but is very natural for Java programming.
The exceptions of the JHI5 are organized as sub-classes of the class HDF5Exception. There are two subclasses of HDF5Exception, HDF5LibraryException and HDF5JavaException. The sub-classes of the former represent errors from the HDF-5 C library, while sub-classes of the latter represent errors in the JHI5 wrapper and support code.
The super-class HDF5LibraryException implements the method 'printStackTrace()', which prints out the HDF-5 error stack, as described in the HDF-5 C API H5Eprint(). This may be used by Java exception handlers to print out the HDF-5 error stack.
- Version:
- HDF5 1.8
See also: hdf.hdf5lib.HDFArray
hdf.hdf5lib.HDF5Constants
hdf.hdf5lib.HDF5CDataTypes
hdf.hdf5lib.HDF5Exception
http://support.hdfgroup.org/HDF5" - See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
H5_LIBRARY_NAME_PROPERTY_KEY
static java.lang.String
H5PATH_PROPERTY_KEY
static int[]
LIB_VERSION
The version number of the HDF5 library: LIB_VERSION[0]: The major version of the library.
-
Constructor Summary
Constructors Constructor Description H5()
-
Method Summary
All Methods Static Methods Concrete Methods Deprecated Methods Modifier and Type Method Description static int
_H5Oopen_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id)
static int
_H5Pclose_class(int plid)
static int
getOpenID(int index)
Deprecated.This no longer returns useful information due to internal code changes.static int
getOpenIDCount()
Get number of open IDs.static java.util.Collection<java.lang.Integer>
getOpenIDs()
Get the open IDsstatic int
H5Aclose(int attr_id)
H5Aclose terminates access to the attribute specified by its identifier, attr_id.static int
H5Acopy(int src_aid, int dst_aid)
H5Acopy copies the content of one attribute to another.static int
H5Acreate(int loc_id, java.lang.String name, int type_id, int space_id, int create_plist)
Deprecated.As of HDF5 1.8, replaced byH5Acreate(int, String, int, int, int, int)
static int
H5Acreate(int loc_id, java.lang.String attr_name, int type_id, int space_id, int acpl_id, int aapl_id)
H5Acreate creates an attribute, attr_name, which is attached to the object specified by the identifier loc_id.static int
H5Acreate_by_name(int loc_id, java.lang.String obj_name, java.lang.String attr_name, int type_id, int space_id, int acpl_id, int aapl_id, int lapl_id)
H5Acreate_by_name creates an attribute, attr_name, which is attached to the object specified by loc_id and obj_name.static int
H5Adelete(int loc_id, java.lang.String name)
H5Adelete removes the attribute specified by its name, name, from a dataset, group, or named datatype.static void
H5Adelete_by_idx(int loc_id, java.lang.String obj_name, int idx_type, int order, long n, int lapl_id)
H5Adelete_by_idx removes an attribute, specified by its location in an index, from an object.static int
H5Adelete_by_name(int loc_id, java.lang.String obj_name, java.lang.String attr_name, int lapl_id)
H5Adelete_by_name removes the attribute attr_name from an object specified by location and name, loc_id and obj_name, respectively.static boolean
H5Aexists(int obj_id, java.lang.String attr_name)
H5Aexists determines whether the attribute attr_name exists on the object specified by obj_id.static boolean
H5Aexists_by_name(int loc_id, java.lang.String obj_name, java.lang.String attr_name, int lapl_id)
H5Aexists_by_name determines whether the attribute attr_name exists on an object.static int
H5Aget_create_plist(int attr_id)
H5Aget_create_plist retrieves a copy of the attribute creation property list identifier.static H5A_info_t
H5Aget_info(int attr_id)
H5Aget_info retrieves attribute information, by attribute identifier.static H5A_info_t
H5Aget_info_by_idx(int loc_id, java.lang.String obj_name, int idx_type, int order, long n, int lapl_id)
H5Aget_info_by_idx Retrieves attribute information, by attribute index position.static H5A_info_t
H5Aget_info_by_name(int loc_id, java.lang.String obj_name, java.lang.String attr_name, int lapl_id)
H5Aget_info_by_name Retrieves attribute information, by attribute name.static java.lang.String
H5Aget_name(int attr_id)
H5Aget_name retrieves the name of an attribute specified by the identifier, attr_id.static java.lang.String
H5Aget_name_by_idx(int attr_id, java.lang.String obj_name, int idx_type, int order, long n, int lapl_id)
H5Aget_name_by_idx retrieves the name of an attribute that is attached to an object, which is specified by its location and name, loc_id and obj_name, respectively.static int
H5Aget_num_attrs(int loc_id)
Deprecated.As of HDF5 1.8, replaced byH5Oget_info(int )
static int
H5Aget_space(int attr_id)
H5Aget_space retrieves a copy of the dataspace for an attribute.static long
H5Aget_storage_size(int attr_id)
H5Aget_storage_size returns the amount of storage that is required for the specified attribute, attr_id.static int
H5Aget_type(int attr_id)
H5Aget_type retrieves a copy of the datatype for an attribute.static int
H5Aiterate(int loc_id, int idx_type, int order, long idx, H5A_iterate_cb op, H5A_iterate_t op_data)
H5Aiterate2 iterates over the attributes attached to a dataset, named datatype, or group, as specified by obj_id.static int
H5Aiterate_by_name(int loc_id, java.lang.String obj_name, int idx_type, int order, long idx, H5A_iterate_cb op, H5A_iterate_t op_data, int lapl_id)
H5Aiterate_by_name iterates over the attributes attached to the dataset or group specified with loc_id and obj_name.static int
H5Aopen(int obj_id, java.lang.String attr_name, int aapl_id)
H5Aopen opens an existing attribute, attr_name, that is attached to an object specified an object identifier, object_id.static int
H5Aopen_by_idx(int loc_id, java.lang.String obj_name, int idx_type, int order, long n, int aapl_id, int lapl_id)
H5Aopen_by_idx opens an existing attribute that is attached to an object specified by location and name, loc_id and obj_name, respectivelystatic int
H5Aopen_by_name(int loc_id, java.lang.String obj_name, java.lang.String attr_name, int aapl_id, int lapl_id)
H5Aopen_by_name Opens an attribute for an object by object name and attribute namestatic int
H5Aopen_idx(int loc_id, int idx)
Deprecated.As of HDF5 1.8, replaced byH5Aopen_by_idx(int, String, int, int, long, int, int)
static int
H5Aopen_name(int loc_id, java.lang.String name)
Deprecated.As of HDF5 1.8, replaced byH5Aopen_by_name(int, String, String, int, int)
static int
H5Aread(int attr_id, int mem_type_id, byte[] buf)
H5Aread reads an attribute, specified with attr_id.static int
H5Aread(int attr_id, int mem_type_id, java.lang.Object obj)
H5Aread reads an attribute, specified with attr_id.static int
H5AreadComplex(int attr_id, int mem_type_id, java.lang.String[] buf)
static int
H5AreadVL(int attr_id, int mem_type_id, java.lang.String[] buf)
static int
H5Arename(int loc_id, java.lang.String old_attr_name, java.lang.String new_attr_name)
H5Arename changes the name of attribute that is attached to the object specified by loc_id.static int
H5Arename_by_name(int loc_id, java.lang.String obj_name, java.lang.String old_attr_name, java.lang.String new_attr_name, int lapl_id)
H5Arename_by_name changes the name of attribute that is attached to the object specified by loc_id and obj_name.static int
H5Awrite(int attr_id, int mem_type_id, byte[] buf)
H5Awrite writes an attribute, specified with attr_id.static int
H5Awrite(int attr_id, int mem_type_id, java.lang.Object obj)
H5Awrite writes an attribute, specified with attr_id.static int
H5AwriteVL(int attr_id, int mem_type_id, java.lang.String[] buf)
static int
H5check_version(int majnum, int minnum, int relnum)
H5check_version verifies that the arguments match the version numbers compiled into the library.static int
H5close()
H5close flushes all data to disk, closes all file identifiers, and cleans up all memory used by the library.static int
H5Dclose(int dataset_id)
H5Dclose ends access to a dataset specified by dataset_id and releases resources used by it.static int
H5Dcopy(int src_did, int dst_did)
H5Dcopy copies the content of one dataset to another dataset.static int
H5Dcreate(int loc_id, java.lang.String name, int type_id, int space_id, int create_plist_id)
Deprecated.As of HDF5 1.8, replaced byH5Dcreate(int, String, int, int, int, int, int)
static int
H5Dcreate(int loc_id, java.lang.String name, int type_id, int space_id, int lcpl_id, int dcpl_id, int dapl_id)
H5Dcreate creates a new dataset named name at the location specified by loc_id.static int
H5Dcreate_anon(int loc_id, int type_id, int space_id, int dcpl_id, int dapl_id)
H5Dcreate_anon creates a dataset in the file specified by loc_id.static int
H5Dextend(int dataset_id, byte[] size)
Deprecated.As of HDF5 1.8, replaced byH5Dset_extent(int, long[])
static int
H5Dextend(int dataset_id, long[] size)
Deprecated.As of HDF5 1.8, replaced byH5Dset_extent(int, long[])
static void
H5Dfill(byte[] fill, int fill_type, byte[] buf, int buf_type, int space_id)
H5Dfill explicitly fills the dataspace selection in memory, space_id, with the fill value specified in fill.static int
H5Dget_access_plist(int dset_id)
H5Dget_access_plist returns an identifier for a copy of the dataset access property list for a dataset.static int
H5Dget_create_plist(int dataset_id)
H5Dget_create_plist returns an identifier for a copy of the dataset creation property list for a dataset.static long
H5Dget_offset(int dset_id)
H5Dget_offset returns the address in the file of the dataset dset_id.static int
H5Dget_space(int dataset_id)
H5Dget_space returns an identifier for a copy of the dataspace for a dataset.static int
H5Dget_space_status(int dset_id)
H5Dget_space_status determines whether space has been allocated for the dataset dset_id.static int
H5Dget_space_status(int dset_id, int[] status)
H5Dget_space_status determines whether space has been allocated for the dataset dset_id.static long
H5Dget_storage_size(int dataset_id)
H5Dget_storage_size returns the amount of storage that is required for the dataset.static int
H5Dget_type(int dataset_id)
H5Dget_type returns an identifier for a copy of the datatype for a dataset.static int
H5Diterate(byte[] buf, int buf_type, int space_id, H5D_iterate_cb op, H5D_iterate_t op_data)
H5Diterate iterates over all the data elements in the memory buffer buf, executing the callback function operator once for each such data element.static int
H5Dopen(int loc_id, java.lang.String name)
Deprecated.As of HDF5 1.8, replaced byH5Dopen(int, String, int)
static int
H5Dopen(int loc_id, java.lang.String name, int dapl_id)
H5Dopen opens the existing dataset specified by a location identifier and name, loc_id and name, respectively.static int
H5Dread(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, byte[] buf)
static int
H5Dread(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, byte[] obj, boolean isCriticalPinning)
H5Dread reads a (partial) dataset, specified by its identifier dataset_id, from the file into the application memory buffer buf.static int
H5Dread(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.Object obj)
static int
H5Dread(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.Object obj, boolean isCriticalPinning)
H5Dread reads a (partial) dataset, specified by its identifier dataset_id, from the file into the application data object.static int
H5Dread_double(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, double[] buf)
static int
H5Dread_double(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, double[] buf, boolean isCriticalPinning)
static int
H5Dread_float(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, float[] buf)
static int
H5Dread_float(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, float[] buf, boolean isCriticalPinning)
static int
H5Dread_int(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, int[] buf)
static int
H5Dread_int(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, int[] buf, boolean isCriticalPinning)
static int
H5Dread_long(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, long[] buf)
static int
H5Dread_long(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, long[] buf, boolean isCriticalPinning)
static int
H5Dread_reg_ref(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.String[] buf)
static int
H5Dread_reg_ref_data(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.String[] buf)
static int
H5Dread_short(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, short[] buf)
static int
H5Dread_short(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, short[] buf, boolean isCriticalPinning)
static int
H5Dread_string(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.String[] buf)
static int
H5DreadVL(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.Object[] buf)
static void
H5Dset_extent(int dset_id, long[] size)
H5Dset_extent sets the current dimensions of the chunked dataset dset_id to the sizes specified in size.static int
H5Dvlen_get_buf_size(int dataset_id, int type_id, int space_id, int[] size)
static long
H5Dvlen_get_buf_size_long(int dset_id, int type_id, int space_id)
H5Dvlen_get_buf_size determines the number of bytes required to store the VL data from the dataset, using the space_id for the selection in the dataset on disk and the type_id for the memory representation of the VL data in memory.static int
H5Dvlen_reclaim(int type_id, int space_id, int xfer_plist_id, byte[] buf)
H5Dvlen_reclaim reclaims buffer used for VL data.static int
H5Dwrite(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, byte[] buf)
static int
H5Dwrite(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, byte[] buf, boolean isCriticalPinning)
H5Dwrite writes a (partial) dataset, specified by its identifier dataset_id, from the application memory buffer buf into the file.static int
H5Dwrite(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.Object obj)
static int
H5Dwrite(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.Object obj, boolean isCriticalPinning)
H5Dwrite writes a (partial) dataset, specified by its identifier dataset_id, from the application memory data object into the file.static int
H5Dwrite_double(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, double[] buf)
static int
H5Dwrite_double(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, double[] buf, boolean isCriticalPinning)
static int
H5Dwrite_float(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, float[] buf)
static int
H5Dwrite_float(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, float[] buf, boolean isCriticalPinning)
static int
H5Dwrite_int(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, int[] buf)
static int
H5Dwrite_int(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, int[] buf, boolean isCriticalPinning)
static int
H5Dwrite_long(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, long[] buf)
static int
H5Dwrite_long(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, long[] buf, boolean isCriticalPinning)
static int
H5Dwrite_short(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, short[] buf)
static int
H5Dwrite_short(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, short[] buf, boolean isCriticalPinning)
static int
H5DwriteString(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.String[] buf)
H5DwriteString writes a (partial) variable length String dataset, specified by its identifier dataset_id, from the application memory buffer buf into the file.static boolean
H5Eauto_is_v2(int stack_id)
H5Eauto_is_v2 determines whether the error auto reporting function for an error stack conforms to the H5E_auto2_t typedef or the H5E_auto1_t typedef.static int
H5Eclear()
H5Eclear clears the error stack for the current thread.static void
H5Eclear(int stack_id)
H5Eclear clears the error stack specified by estack_id, or, if estack_id is set to H5E_DEFAULT, the error stack for the current thread.static void
H5Eclear2(int stack_id)
H5Eclear2 clears the error stack specified by estack_id, or, if estack_id is set to H5E_DEFAULT, the error stack for the current thread.static void
H5Eclose_msg(int err_id)
H5Eclose_msg closes an error message identifier, which can be either a major or minor message.static void
H5Eclose_stack(int stack_id)
H5Eclose_stack closes the object handle for an error stack and releases its resources.static int
H5Ecreate_msg(int cls_id, int msg_type, java.lang.String msg)
H5Ecreate_msg adds an error message to an error class defined by client library or application program.static int
H5Ecreate_stack()
H5Ecreate_stack creates a new empty error stack and returns the new stack's identifier.static java.lang.String
H5Eget_class_name(int class_id)
H5Eget_class_name retrieves the name of the error class specified by the class identifier.static int
H5Eget_current_stack()
H5Eget_current_stack copies the current error stack and returns an error stack identifier for the new copy.static java.lang.String
H5Eget_msg(int msg_id, int[] type_list)
H5Eget_msg retrieves the error message including its length and type.static long
H5Eget_num(int stack_id)
H5Eget_num retrieves the number of error records in the error stack specified by estack_id (including major, minor messages and description).static void
H5Epop(int stack_id, long count)
H5Epop deletes the number of error records specified in count from the top of the error stack specified by estack_id (including major, minor messages and description).static void
H5Eprint1(java.lang.Object stream)
Deprecated.As of HDF5 1.8, replaced byH5Eprint2(int, Object)
static void
H5Eprint2(int stack_id, java.lang.Object stream)
H5Eprint2 prints the error stack specified by estack_id on the specified stream, stream.static void
H5Epush(int stack_id, java.lang.String file, java.lang.String func, int line, int cls_id, int maj_id, int min_id, java.lang.String msg)
H5Epush2 pushes a new error record onto the error stack specified by estack_id.static void
H5Epush2(int stack_id, java.lang.String file, java.lang.String func, int line, int cls_id, int maj_id, int min_id, java.lang.String msg)
static int
H5Eregister_class(java.lang.String cls_name, java.lang.String lib_name, java.lang.String version)
H5Eregister_class registers a client library or application program to the HDF5 error API so that the client library or application program can report errors together with HDF5 library.static int
H5error_off()
Turn off error handling By default, the C library prints the error stack of the HDF-5 C library on stdout.static void
H5Eset_current_stack(int stack_id)
H5Eset_current_stack replaces the content of the current error stack with a copy of the content of the error stack specified by estack_id.static void
H5Eunregister_class(int class_id)
H5Eunregister_class removes the error class specified by class_id.static void
H5Ewalk(int stack_id, int direction, H5E_walk_cb func, H5E_walk_t client_data)
H5Ewalk walks the error stack specified by estack_id for the current thread and calls the function specified in func for each error along the way.static void
H5Ewalk2(int stack_id, int direction, H5E_walk_cb func, H5E_walk_t client_data)
static void
H5export_dataset(java.lang.String file_export_name, java.lang.String file_name, java.lang.String object_path, int binary_order)
H5export_dataset is a utility function to save data in a file.static void
H5Fclear_elink_file_cache(int file_id)
H5Fclear_elink_file_cache evicts all the cached child files in the specified file's external file cache, causing them to be closed if there is nothing else holding them open.static int
H5Fclose(int file_id)
H5Fclose terminates access to an HDF5 file.static int
H5Fcreate(java.lang.String name, int flags, int create_id, int access_id)
H5Fcreate is the primary function for creating HDF5 files.static int
H5Fflush(int object_id, int scope)
H5Fflush causes all buffers associated with a file or object to be immediately flushed (written) to disk without removing the data from the (memory) cache.static int
H5Fget_access_plist(int file_id)
H5Fget_access_plist returns the file access property list identifier of the specified file.static int
H5Fget_create_plist(int file_id)
H5Fget_create_plist returns a file creation property list identifier identifying the creation properties used to create this file.static long
H5Fget_filesize(int file_id)
static long
H5Fget_freespace(int file_id)
H5Fget_freespace returns the amount of space that is unused by any objects in the file.static H5F_info_t
H5Fget_info(int obj_id)
H5Fget_info returns global information for the file associated with the object identifier obj_id.static int
H5Fget_intent(int file_id)
H5Fget_intent retrieves the intended access mode flag passed with H5Fopen when the file was opened.static double
H5Fget_mdc_hit_rate(int file_id)
H5Fget_mdc_hit_rate queries the metadata cache of the target file to obtain its hit rate (cache hits / (cache hits + cache misses)) since the last time hit rate statistics were reset.static int
H5Fget_mdc_size(int file_id, long[] metadata_cache)
H5Fget_mdc_size queries the metadata cache of the target file for the desired size information.static java.lang.String
H5Fget_name(int obj_id)
H5Fget_name retrieves the name of the file to which the object obj_id belongs.static java.lang.String
H5Fget_name(int obj_id, int size)
static int
H5Fget_obj_count(int file_id, int types)
H5Fget_obj_count returns the number of open object identifiers for the file.static long
H5Fget_obj_count_long(int file_id, int types)
H5Fget_obj_count returns the number of open object identifiers for the file.static int
H5Fget_obj_ids(int file_id, int types, int max_objs, int[] obj_id_list)
H5Fget_obj_ids returns the list of identifiers for all open HDF5 objects fitting the specified criteria.static long
H5Fget_obj_ids_long(int file_id, int types, long max_objs, int[] obj_id_list)
H5Fget_obj_ids returns the list of identifiers for all open HDF5 objects fitting the specified criteria.static boolean
H5Fis_hdf5(java.lang.String name)
H5Fis_hdf5 determines whether a file is in the HDF5 format.static int
H5Fmount(int loc_id, java.lang.String name, int child_id, int plist_id)
H5Fmount mounts the file specified by child_id onto the group specified by loc_id and name using the mount properties plist_id.static int
H5Fopen(java.lang.String name, int flags, int access_id)
H5Fopen opens an existing file and is the primary function for accessing existing HDF5 files.static int
H5Freopen(int file_id)
H5Freopen reopens an HDF5 file.static void
H5Freset_mdc_hit_rate_stats(int file_id)
H5Freset_mdc_hit_rate_stats resets the hit rate statistics counters in the metadata cache associated with the specified file.static int
H5Funmount(int loc_id, java.lang.String name)
Given a mount point, H5Funmount dissassociates the mount point's file from the file mounted there.static int
H5garbage_collect()
H5garbage_collect collects on all free-lists of all types.static int
H5Gclose(int group_id)
H5Gclose releases resources used by a group which was opened by a call to H5Gcreate() or H5Gopen().static int
H5Gcreate(int loc_id, java.lang.String name, int lcpl_id, int gcpl_id, int gapl_id)
H5Gcreate creates a new group with the specified name at the specified location, loc_id.static int
H5Gcreate(int loc_id, java.lang.String name, long size_hint)
Deprecated.As of HDF5 1.8, replaced byH5Gcreate(int, String, int, int, int)
static int
H5Gcreate_anon(int loc_id, int gcpl_id, int gapl_id)
H5Gcreate_anon creates a new empty group in the file specified by loc_id.static int
H5get_libversion(int[] libversion)
H5get_libversion retrieves the major, minor, and release numbers of the version of the HDF library which is linked to the application.static int
H5Gget_comment(int loc_id, java.lang.String name, int bufsize, java.lang.String[] comment)
Deprecated.As of HDF5 1.8, replaced byH5Oget_comment(int)
static int
H5Gget_create_plist(int group_id)
H5Gget_create_plist returns an identifier for the group creation property list associated with the group specified by group_id.static H5G_info_t
H5Gget_info(int group_id)
H5Gget_info retrieves information about the group specified by group_id.static H5G_info_t
H5Gget_info_by_idx(int group_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id)
H5Gget_info_by_idx retrieves information about a group, according to the group's position within an index.static H5G_info_t
H5Gget_info_by_name(int group_id, java.lang.String name, int lapl_id)
H5Gget_info_by_name retrieves information about the group group_name located in the file or group specified by loc_id.static int
H5Gget_linkval(int loc_id, java.lang.String name, int size, java.lang.String[] value)
Deprecated.As of HDF5 1.8, replaced byH5Lget_val(int, String, String[] , int)
static int
H5Gget_num_objs(int loc_id, long[] num_obj)
Deprecated.As of HDF5 1.8, replaced byH5Gget_info(int)
static int
H5Gget_obj_info_all(int loc_id, java.lang.String name, java.lang.String[] oname, int[] otype, int[] ltype, long[] ref, int indx_type)
static int
H5Gget_obj_info_all(int loc_id, java.lang.String name, java.lang.String[] oname, int[] otype, int[] ltype, long[] fno, long[] ref, int indx_type)
static int
H5Gget_obj_info_all(int loc_id, java.lang.String name, java.lang.String[] objNames, int[] objTypes, long[] objRef)
retrieves information of all objects under the group (name) located in the file or group specified by loc_id.static int
H5Gget_obj_info_full(int loc_id, java.lang.String name, java.lang.String[] oname, int[] otype, int[] ltype, long[] fno, long[] ref, int indx_type, int indx_order)
static int
H5Gget_obj_info_idx(int loc_id, java.lang.String name, int idx, java.lang.String[] oname, int[] type)
H5Gget_obj_info_idx report the name and type of object with index 'idx' in a Group.static int
H5Gget_obj_info_max(int loc_id, java.lang.String[] objNames, int[] objTypes, int[] lnkTypes, long[] objRef, int objMax)
retrieves information of all objects (recurvisely) under the group (name) located in the file or group specified by loc_id upto maximum specified by objMax.static int
H5Gget_objinfo(int loc_id, java.lang.String name, boolean follow_link, long[] fileno, long[] objno, int[] link_info, long[] mtime)
Deprecated.As of HDF5 1.8, replaced byand #H5Oget_info(int)
static int
H5Gget_objinfo(int loc_id, java.lang.String name, boolean follow_link, HDF5GroupInfo info)
Deprecated.As of HDF5 1.8static long
H5Gget_objname_by_idx(int group_id, long idx, java.lang.String[] name, long size)
Deprecated.As of HDF5 1.8, replaced byH5Lget_name_by_idx(int, String, int, int, long, int)
static int
H5Gget_objtype_by_idx(int group_id, long idx)
Deprecated.As of HDF5 1.8, replaced byH5Oget_info(int)
static int
H5Glink(int loc_id, int link_type, java.lang.String current_name, java.lang.String new_name)
Deprecated.As of HDF5 1.8, replaced byand #H5Lcreate_soft(String, int, String, int, int)
static int
H5Glink2(int curr_loc_id, java.lang.String current_name, int link_type, int new_loc_id, java.lang.String new_name)
Deprecated.As of HDF5 1.8static int
H5Gmove(int loc_id, java.lang.String src, java.lang.String dst)
Deprecated.As of HDF5 1.8, replaced byH5Lmove(int, String, int,String, int, int)
static int
H5Gn_members(int loc_id, java.lang.String name)
H5Gn_members report the number of objects in a Group.static long
H5Gn_members_long(int loc_id, java.lang.String name)
H5Gn_members report the number of objects in a Group.static int
H5Gopen(int loc_id, java.lang.String name)
Deprecated.As of HDF5 1.8, replaced byH5Gopen(int, String, int)
static int
H5Gopen(int loc_id, java.lang.String name, int gapl_id)
H5Gopen opens an existing group, name, at the location specified by loc_id.static int
H5Gset_comment(int loc_id, java.lang.String name, java.lang.String comment)
Deprecated.As of HDF5 1.8, replaced byH5Oset_comment(int, String)
static int
H5Gunlink(int loc_id, java.lang.String name)
Deprecated.As of HDF5 1.8, replaced byH5Ldelete(int, String, int)
static void
H5Iclear_type(int type_id, boolean force)
H5Iclear_type deletes all identifiers of the type identified by the argument type.static int
H5Idec_ref(int obj_id)
static int
H5Idec_type_ref(int type_id)
H5Idec_type_ref decrements the reference count on an identifier type.static void
H5Idestroy_type(int type_id)
H5Idestroy_type deletes an entire identifier type.static int
H5Iget_file_id(int obj_id)
static java.lang.String
H5Iget_name(int obj_id)
H5Iget_name_str retrieves the name of an object specified by the identifier, obj_id.static long
H5Iget_name_long(int obj_id, java.lang.String[] name, long size)
Deprecated.static int
H5Iget_ref(int obj_id)
static int
H5Iget_type(int obj_id)
H5Iget_type retrieves the type of the object identified by obj_id.static int
H5Iget_type_ref(int type_id)
H5Iget_type_ref retrieves the reference count on an ID type.static int
H5Iinc_ref(int obj_id)
static int
H5Iinc_type_ref(int type_id)
H5Iinc_type_ref increments the reference count on an ID type.static boolean
H5Iis_valid(int obj_id)
H5Iis_valid indicates if the identifier type specified in obj_id is valid.static int
H5Inmembers(int type_id)
H5Inmembers returns the number of identifiers of the identifier type specified in type.static boolean
H5Itype_exists(int type_id)
H5Itype_exists indicates if the identifier type specified in type exists.static void
H5Lcopy(int src_loc, java.lang.String src_name, int dst_loc, java.lang.String dst_name, int lcpl_id, int lapl_id)
H5Lcopy copies a link from one location to another.static void
H5Lcreate_external(java.lang.String file_name, java.lang.String obj_name, int link_loc_id, java.lang.String link_name, int lcpl_id, int lapl_id)
H5Lcreate_external creates a new soft link to an external object, which is an object in a different HDF5 file from the location of the link.static void
H5Lcreate_hard(int cur_loc, java.lang.String cur_name, int dst_loc, java.lang.String dst_name, int lcpl_id, int lapl_id)
H5Lcreate_hard creates a new hard link to a pre-existing object in an HDF5 file.static void
H5Lcreate_soft(java.lang.String link_target, int link_loc_id, java.lang.String link_name, int lcpl_id, int lapl_id)
H5Lcreate_soft creates a new soft link to an object in an HDF5 file.static void
H5Ldelete(int loc_id, java.lang.String name, int lapl_id)
H5Ldelete removes the link specified from a group.static void
H5Ldelete_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id)
H5Ldelete_by_idx removes the nth link in a group according to the specified order and in the specified index.static boolean
H5Lexists(int loc_id, java.lang.String name, int lapl_id)
H5Lexists checks if a link with a particular name exists in a group.static H5L_info_t
H5Lget_info(int loc_id, java.lang.String name, int lapl_id)
H5Lget_info returns information about the specified link.static H5L_info_t
H5Lget_info_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id)
H5Lget_info_by_idx opens a named datatype at the location specified by loc_id and return an identifier for the datatype.static java.lang.String
H5Lget_name_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id)
H5Lget_name_by_idx retrieves name of the nth link in a group, according to the order within a specified field or index.static int
H5Lget_val(int loc_id, java.lang.String name, java.lang.String[] link_value, int lapl_id)
H5Lget_val returns the link value of a symbolic link.static int
H5Lget_val_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, java.lang.String[] link_value, int lapl_id)
H5Lget_val_by_idx retrieves value of the nth link in a group, according to the order within an index.static int
H5Lis_registered(int link_cls_id)
H5Lis_registered tests whether a user-defined link class is currently registered, either by the HDF5 Library or by the user through the use of H5Lregister.static int
H5Literate(int grp_id, int idx_type, int order, long idx, H5L_iterate_cb op, H5L_iterate_t op_data)
H5Literate iterates through links in a group.static int
H5Literate_by_name(int grp_id, java.lang.String group_name, int idx_type, int order, long idx, H5L_iterate_cb op, H5L_iterate_t op_data, int lapl_id)
H5Literate_by_name iterates through links in a group.static void
H5Lmove(int src_loc, java.lang.String src_name, int dst_loc, java.lang.String dst_name, int lcpl_id, int lapl_id)
H5Lmove renames a link within an HDF5 file.static void
H5Lunregister(int link_cls_id)
H5Lunregister unregisters a class of user-defined links, preventing them from being traversed, queried, moved, etc.static int
H5Lvisit(int grp_id, int idx_type, int order, H5L_iterate_cb op, H5L_iterate_t op_data)
H5Lvisit recursively visits all links starting from a specified group.static int
H5Lvisit_by_name(int loc_id, java.lang.String group_name, int idx_type, int order, H5L_iterate_cb op, H5L_iterate_t op_data, int lapl_id)
H5Lvisit_by_name recursively visits all links starting from a specified group.static int
H5Oclose(int object_id)
H5Oclose closes the group, dataset, or named datatype specified.static void
H5Ocopy(int src_loc_id, java.lang.String src_name, int dst_loc_id, java.lang.String dst_name, int ocpypl_id, int lcpl_id)
H5Ocopy copies the group, dataset or named datatype specified from the file or group specified by source location to the destination location.static void
H5Odecr_refcount(int object_id)
H5Odecr_refcount decrements the hard link reference count for an object.static boolean
H5Oexists_by_name(int loc_id, java.lang.String obj_name, int lapl_id)
H5Oexists_by_name is used by an application to check that an existing link resolves to an object.static java.lang.String
H5Oget_comment(int obj_id)
H5Oget_comment retrieves the comment for the specified object.static java.lang.String
H5Oget_comment_by_name(int loc_id, java.lang.String name, int lapl_id)
H5Oget_comment_by_name retrieves the comment for an object.static H5O_info_t
H5Oget_info(int loc_id)
H5Oget_info retrieves the metadata for an object specified by an identifier.static H5O_info_t
H5Oget_info_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id)
H5Oget_info_by_idx retrieves the metadata for an object, identifying the object by an index position.static H5O_info_t
H5Oget_info_by_name(int loc_id, java.lang.String name, int lapl_id)
H5Oget_info_by_name retrieves the metadata for an object, identifying the object by location and relative name.static void
H5Oincr_refcount(int object_id)
H5Oincr_refcount increments the hard link reference count for an object.static void
H5Olink(int obj_id, int new_loc_id, java.lang.String new_name, int lcpl_id, int lapl_id)
H5Olink creates a new hard link to an object in an HDF5 file.static int
H5Oopen(int loc_id, java.lang.String name, int lapl_id)
H5Oopen opens a group, dataset, or named datatype specified by a location and a path name.static int
H5Oopen_by_addr(int loc_id, long addr)
H5Oopen_by_addr opens a group, dataset, or named datatype using its address within an HDF5 file.static int
H5Oopen_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id)
H5Oopen_by_idx opens the nth object in the group specified.static int
H5open()
H5open initialize the library.static void
H5Oset_comment(int obj_id, java.lang.String comment)
Deprecated.As of HDF5 1.8 in favor of object attributes.static void
H5Oset_comment_by_name(int loc_id, java.lang.String name, java.lang.String comment, int lapl_id)
Deprecated.As of HDF5 1.8 in favor of object attributes.static int
H5Ovisit(int obj_id, int idx_type, int order, H5O_iterate_cb op, H5O_iterate_t op_data)
H5Ovisit recursively visits all objects accessible from a specified object.static int
H5Ovisit_by_name(int loc_id, java.lang.String obj_name, int idx_type, int order, H5O_iterate_cb op, H5O_iterate_t op_data, int lapl_id)
H5Ovisit_by_name recursively visits all objects starting from a specified object.static boolean
H5P_equal(int plid1, int plid2)
static boolean
H5Pall_filters_avail(int dcpl_id)
static int
H5Pclose(int plist)
H5Pclose terminates access to a property list.static int
H5Pclose_class(int plid)
Closes an existing property list classstatic int
H5Pcopy(int plist)
H5Pcopy copies an existing property list to create a new property list.static int
H5Pcopy_prop(int dst_id, int src_id, java.lang.String name)
H5Pcopy_prop copies a property from one property list or class to anotherstatic int
H5Pcreate(int type)
H5Pcreate creates a new property as an instance of some property list class.static int
H5Pcreate_class_nocb(int parent_class, java.lang.String name)
static int
H5Pequal(int plid1, int plid2)
H5Pequal determines if two property lists or classes are equalstatic int
H5Pexist(int plid, java.lang.String name)
H5Pexist determines whether a property exists within a property list or classstatic int
H5Pfill_value_defined(int plist_id, int[] status)
static int
H5Pget(int plid, java.lang.String name)
H5Pget retrieves a copy of the value for a property in a property list (support integer only)static int
H5Pget_alignment(int plist, long[] alignment)
H5Pget_alignment retrieves the current settings for alignment properties from a file access property list.static int
H5Pget_alloc_time(int plist_id, int[] alloc_time)
static int
H5Pget_attr_creation_order(int ocpl_id)
H5Pget_attr_creation_order retrieves the settings for tracking and indexing attribute creation order on an objectstatic int
H5Pget_attr_phase_change(int ocpl_id, int[] attributes)
H5Pget_attr_phase_change retrieves attribute storage phase change thresholds.static int
H5Pget_btree_ratios(int plist_id, double[] left, double[] middle, double[] right)
H5Pget_btree_ratio Get the B-tree split ratios for a dataset transfer property list.static int
H5Pget_buffer(int plist, byte[] tconv, byte[] bkg)
HH5Pget_buffer gets type conversion and background buffers.static long
H5Pget_buffer_size(int plist)
static int
H5Pget_cache(int plist, int[] mdc_nelmts, int[] rdcc_nelmts, int[] rdcc_nbytes, double[] rdcc_w0)
Deprecated.As of HDF5 1.8, replaced byH5Pget_cache(int, int[], long[], long[], double[])
because of possible loss of precisionstatic int
H5Pget_cache(int plist, int[] mdc_nelmts, long[] rdcc_nelmts, long[] rdcc_nbytes, double[] rdcc_w0)
Retrieves the maximum possible number of elements in the meta data cache and the maximum possible number of bytes and the RDCC_W0 value in the raw data chunk cache.static int
H5Pget_char_encoding(int plist_id)
static int
H5Pget_chunk(int plist, int max_ndims, long[] dims)
H5Pget_chunk retrieves the size of chunks for the raw data of a chunked layout dataset.static void
H5Pget_chunk_cache(int dapl_id, long[] rdcc_nslots, long[] rdcc_nbytes, double[] rdcc_w0)
Retrieves the maximum possible number of elements in the meta data cache and the maximum possible number of bytes and the RDCC_W0 value in the raw data chunk cache on a per-datset basis.static int
H5Pget_class(int plist)
H5Pget_class returns the property list class for the property list identified by the plist parameter.static java.lang.String
H5Pget_class_name(int plid)
H5Pget_class_name retrieves the name of a generic property list classstatic int
H5Pget_class_parent(int plid)
H5Pget_class_parent retrieves an identifier for the parent class of a property classstatic int
H5Pget_copy_object(int ocp_plist_id)
H5Pget_copy_object retrieves the properties to be used when an object is copied.static boolean
H5Pget_create_intermediate_group(int lcpl_id)
H5Pget_create_intermediate_group determines whether property is set to enable creating missing intermediate groups.static long
H5Pget_data_transform(int plist_id, java.lang.String[] expression, long size)
H5Pget_data_transform retrieves the data transform expression previously set in the dataset transfer property list plist_id by H5Pset_data_transform.static int
H5Pget_driver(int plid)
H5Pget_driver returns the identifier of the low-level file driver associated with the file access property list or data transfer property list plid.static int
H5Pget_edc_check(int plist)
static int
H5Pget_elink_acc_flags(int lapl_id)
H5Pget_elink_acc_flags retrieves the external link traversal file access flag from the specified link access property list.static int
H5Pget_elink_fapl(int lapl_id)
H5Pget_elink_fapl Retrieves the file access property list identifier associated with the link access property list.static int
H5Pget_elink_file_cache_size(int fapl_id)
H5Pget_elink_file_cache_size retrieves the size of the external link open file cache.static long
H5Pget_elink_prefix(int lapl_id, java.lang.String[] prefix)
H5Pget_elink_prefix Retrieves prefix applied to external link paths.static int
H5Pget_est_link_info(int gcpl_id, int[] link_info)
H5Pget_est_link_info Queries data required to estimate required local heap or object header size.static int
H5Pget_external(int plist, int idx, long name_size, java.lang.String[] name, long[] size)
H5Pget_external returns information about an external file.static int
H5Pget_external_count(int plist)
H5Pget_external_count returns the number of external files for the specified dataset.static long
H5Pget_family_offset(int fapl_id)
static void
H5Pget_fapl_core(int fapl_id, long[] increment, boolean[] backing_store)
static int
H5Pget_fapl_direct(int fapl_id, long[] info)
H5Pget_fapl_direct Retrieve direct I/O settings.static int
H5Pget_fapl_family(int fapl_id, long[] memb_size, int[] memb_fapl_id)
static boolean
H5Pget_fapl_multi(int fapl_id, int[] memb_map, int[] memb_fapl, java.lang.String[] memb_name, long[] memb_addr)
H5Pget_fapl_multi Sets up use of the multi I/O driver.static int
H5Pget_fclose_degree(int plist_id)
static int
H5Pget_fill_time(int plist_id, int[] fill_time)
static int
H5Pget_fill_value(int plist_id, int type_id, byte[] value)
H5Pget_fill_value queries the fill value property of a dataset creation property list.static int
H5Pget_fill_value(int plist_id, int type_id, java.lang.Object obj)
H5Pget_fill_value queries the fill value property of a dataset creation property list.static int
H5Pget_filter(int plist, int filter_number, int[] flags, int[] cd_nelmts, int[] cd_values, int namelen, java.lang.String[] name)
Deprecated.As of HDF5 1.8, replaced byH5Pget_filter(int, int, int[], long[], int[], long, String[], int[])
static int
H5Pget_filter(int plist, int filter_number, int[] flags, long[] cd_nelmts, int[] cd_values, long namelen, java.lang.String[] name, int[] filter_config)
H5Pget_filter returns information about a filter, specified by its filter number, in a filter pipeline, specified by the property list with which it is associated.static int
H5Pget_filter_by_id(int plist_id, int filter_id, int[] flags, long[] cd_nelmts, int[] cd_values, long namelen, java.lang.String[] name)
Deprecated.As of HDF5 1.8, replaced byH5Pget_filter_by_id(int, int, int[], long[], int[], long, String[], int[])
static int
H5Pget_filter_by_id(int plist_id, int filter_id, int[] flags, long[] cd_nelmts, int[] cd_values, long namelen, java.lang.String[] name, int[] filter_config)
H5Pget_filter_by_id returns information about the filter specified in filter_id, a filter identifier.static int
H5Pget_filter_by_id2(int plist_id, int filter_id, int[] flags, long[] cd_nelmts, int[] cd_values, long namelen, java.lang.String[] name, int[] filter_config)
H5Pget_filter_by_id2 returns information about a filter, specified by its filter id, in a filter pipeline, specified by the property list with which it is associated.static int
H5Pget_gc_reference(int fapl_id, boolean[] gc_ref)
static int
H5Pget_gc_references(int fapl_id, boolean[] gc_ref)
H5Pget_gc_references Returns the current setting for the garbage collection refernces property from a file access property list.static boolean
H5Pget_gcreferences(int fapl_id)
static int
H5Pget_hyper_vector_size(int dxpl_id, long[] vector_size)
static int
H5Pget_istore_k(int plist, int[] ik)
H5Pget_istore_k queries the 1/2 rank of an indexed storage B-tree.static int
H5Pget_layout(int plist)
H5Pget_layout returns the layout of the raw data for a dataset.static int
H5Pget_libver_bounds(int fapl_id, int[] libver)
H5Pget_libver_bounds retrieves the lower and upper bounds on the HDF5 Library versions that indirectly determine the object formats versions used when creating objects in the file.static int
H5Pget_link_creation_order(int gcpl_id)
H5Pget_link_creation_order queries the group creation property list, gcpl_id, and returns a flag indicating whether link creation order is tracked and/or indexed in a group.static int
H5Pget_link_phase_change(int gcpl_id, int[] links)
H5Pget_link_phase_change Queries the settings for conversion between compact and dense groups.static long
H5Pget_local_heap_size_hint(int gcpl_id)
H5Pget_local_heap_size_hint Retrieves the anticipated size of the local heap for original-style groups.static H5AC_cache_config_t
H5Pget_mdc_config(int plist_id)
H5Pget_mdc_config gets the initial metadata cache configuration contained in a file access property list and loads it into the instance of H5AC_cache_config_t pointed to by the config_ptr parameter.static long
H5Pget_meta_block_size(int fapl_id)
H5Pget_meta_block_size the current metadata block size setting.static int
H5Pget_nfilters(int plist)
H5Pget_nfilters returns the number of filters defined in the filter pipeline associated with the property list plist.static long
H5Pget_nlinks(int lapl_id)
H5Pget_nlinks retrieves the maximum number of soft or user-defined link traversals allowed, nlinks, before the library assumes it has found a cycle and aborts the traversal.static long
H5Pget_nprops(int plid)
H5Pget_nprops retrieves the number of properties in a property list or classstatic boolean
H5Pget_obj_track_times(int ocpl_id)
H5Pget_obj_track_times queries the object creation property list, ocpl_id, to determine whether object times are being recorded.static int
H5Pget_preserve(int plist)
Deprecated.As of HDF5 1.8, compound datatype field preservation is now core functionality in the HDF5 Library.static int
H5Pget_shared_mesg_index(int fcpl_id, int index_num, int[] mesg_info)
H5Pget_shared_mesg_index Retrieves the configuration settings for a shared message index.static int
H5Pget_shared_mesg_nindexes(int fcpl_id)
H5Pget_shared_mesg_nindexes retrieves number of shared object header message indexes in file creation property list.static int
H5Pget_shared_mesg_phase_change(int fcpl_id, int[] size)
H5Pget_shared_mesg_phase_change retrieves shared object header message phase change information.static long
H5Pget_sieve_buf_size(int fapl_id)
static long
H5Pget_size(int plid, java.lang.String name)
H5Pget_size retrieves the size of a property's value in bytesstatic int
H5Pget_sizes(int plist, long[] size)
H5Pget_sizes retrieves the size of the offsets and lengths used in an HDF5 file.static int
H5Pget_small_data_block_size(int plist, long[] size)
H5Pget_small_data_block_size retrieves the size of a block of small data in a file creation property list.static long
H5Pget_small_data_block_size_long(int plist)
static int
H5Pget_sym_k(int plist, int[] size)
H5Pget_sym_k retrieves the size of the symbol table B-tree 1/2 rank and the symbol table leaf node 1/2 size.static int
H5Pget_userblock(int plist, long[] size)
H5Pget_userblock retrieves the size of a user block in a file creation property list.static int
H5Pget_version(int plist, int[] version_info)
H5Pget_version retrieves the version information of various objects for a file creation property list.static void
H5Pinsert2_nocb(int plist, java.lang.String name, long size, byte[] value)
static int
H5Pisa_class(int plist, int pclass)
H5Pisa_class checks to determine whether a property list is a member of the specified classstatic int
H5Piterate(int plist, int[] idx, H5P_iterate_cb op, H5P_iterate_t op_data)
static int
H5PLget_loading_state()
H5PLget_loading_state retrieves the state of the dynamic plugins flag, plugin_flags..static void
H5PLset_loading_state(int plugin_flags)
H5PLset_loading_state uses one argument to enable or disable individual plugins.static int
H5Pmodify_filter(int plist, int filter, int flags, long cd_nelmts, int[] cd_values)
static void
H5Pregister2_nocb(int plist_class, java.lang.String name, long size, byte[] def_value)
static int
H5Premove(int plid, java.lang.String name)
H5Premove removes a property from a property liststatic int
H5Premove_filter(int obj_id, int filter)
static int
H5Pset(int plid, java.lang.String name, int value)
Sets a property list value (support integer only)static int
H5Pset_alignment(int plist, long threshold, long alignment)
H5Pset_alignment sets the alignment properties of a file access property list so that any file object >= THRESHOLD bytes will be aligned on an address which is a multiple of ALIGNMENT.static int
H5Pset_alloc_time(int plist_id, int alloc_time)
static int
H5Pset_attr_creation_order(int ocpl_id, int crt_order_flags)
H5Pset_attr_creation_order sets flags specifying whether to track and index attribute creation order on an object.static void
H5Pset_attr_phase_change(int ocpl_id, int max_compact, int min_dense)
H5Pset_attr_phase_change sets threshold values for attribute storage on an object.static int
H5Pset_btree_ratios(int plist_id, double left, double middle, double right)
H5Pset_btree_ratio Sets B-tree split ratios for a dataset transfer property list.static void
H5Pset_buffer_size(int plist, long size)
H5Pset_buffer sets type conversion and background buffers.static int
H5Pset_cache(int plist, int mdc_nelmts, long rdcc_nelmts, long rdcc_nbytes, double rdcc_w0)
H5Pset_cache sets the number of elements (objects) in the meta data cache and the total number of bytes in the raw data chunk cache.static void
H5Pset_char_encoding(int plist_id, int encoding)
static int
H5Pset_chunk(int plist, int ndims, byte[] dim)
H5Pset_chunk sets the size of the chunks used to store a chunked layout dataset.static int
H5Pset_chunk(int plist, int ndims, long[] dim)
static void
H5Pset_chunk_cache(int dapl_id, long rdcc_nslots, long rdcc_nbytes, double rdcc_w0)
H5Pset_chunk_cache sets the number of elements (objects) in the meta data cache and the total number of bytes in the raw data chunk cache on a per-datset basis.static void
H5Pset_copy_object(int ocp_plist_id, int copy_options)
H5Pset_copy_object Sets properties to be used when an object is copied.static int
H5Pset_create_intermediate_group(int lcpl_id, boolean crt_intermed_group)
H5Pset_create_intermediate_group specifies in property list whether to create missing intermediate groupsstatic int
H5Pset_data_transform(int plist_id, java.lang.String expression)
H5Pset_data_transform sets a data transform expressionstatic int
H5Pset_deflate(int plist, int level)
H5Pset_deflate sets the compression method for a dataset.static int
H5Pset_edc_check(int plist, int check)
static int
H5Pset_elink_acc_flags(int lapl_id, int flags)
H5Pset_elink_acc_flags Sets the external link traversal file access flag in a link access property list.static int
H5Pset_elink_fapl(int lapl_id, int fapl_id)
H5Pset_elink_fapl sets a file access property list for use in accessing a file pointed to by an external link.static void
H5Pset_elink_file_cache_size(int fapl_id, int efc_size)
H5Pset_elink_file_cache_size sets the number of files that can be held open in an external link open file cache.static int
H5Pset_elink_prefix(int lapl_id, java.lang.String prefix)
H5Pset_elink_prefix Sets prefix to be applied to external link paths.static int
H5Pset_est_link_info(int gcpl_id, int est_num_entries, int est_name_len)
H5Pset_est_link_info Sets estimated number of links and length of link names in a group.static int
H5Pset_external(int plist, java.lang.String name, long offset, long size)
H5Pset_external adds an external file to the list of external files.static int
H5Pset_family_offset(int fapl_id, long offset)
static int
H5Pset_fapl_core(int fapl_id, long increment, boolean backing_store)
static int
H5Pset_fapl_direct(int fapl_id, long alignment, long block_size, long cbuf_size)
H5Pset_fapl_direct Sets up use of the direct I/O driver.static int
H5Pset_fapl_family(int fapl_id, long memb_size, int memb_fapl_id)
static int
H5Pset_fapl_log(int fapl_id, java.lang.String logfile, int flags, int buf_size)
Deprecated.As of HDF5 1.8.7, replaced byH5Pset_fapl_log(int, String, long, long)
static void
H5Pset_fapl_log(int fapl_id, java.lang.String logfile, long flags, long buf_size)
H5Pset_fapl_log Sets up the logging virtual file driver (H5FD_LOG) for use.static void
H5Pset_fapl_multi(int fapl_id, int[] memb_map, int[] memb_fapl, java.lang.String[] memb_name, long[] memb_addr, boolean relax)
H5Pset_fapl_multi Sets up use of the multi I/O driver.static int
H5Pset_fapl_sec2(int fapl_id)
static void
H5Pset_fapl_split(int fapl_id, java.lang.String meta_ext, int meta_plist_id, java.lang.String raw_ext, int raw_plist_id)
static int
H5Pset_fapl_stdio(int fapl_id)
static int
H5Pset_fapl_windows(int fapl_id)
static int
H5Pset_fclose_degree(int plist, int degree)
static int
H5Pset_fill_time(int plist_id, int fill_time)
static int
H5Pset_fill_value(int plist_id, int type_id, byte[] value)
H5Pset_fill_value sets the fill value for a dataset creation property list.static int
H5Pset_fill_value(int plist_id, int type_id, java.lang.Object obj)
H5Pset_fill_value sets the fill value for a dataset creation property list.static int
H5Pset_filter(int plist, int filter, int flags, long cd_nelmts, int[] cd_values)
H5Pset_filter adds the specified filter and corresponding properties to the end of an output filter pipeline.static int
H5Pset_fletcher32(int plist)
static int
H5Pset_gc_references(int fapl_id, boolean gc_ref)
H5Pset_gc_references Sets the flag for garbage collecting references for the file.static int
H5Pset_hyper_vector_size(int dxpl_id, long vector_size)
static int
H5Pset_istore_k(int plist, int ik)
H5Pset_istore_k sets the size of the parameter used to control the B-trees for indexing chunked datasets.static int
H5Pset_layout(int plist, int layout)
H5Pset_layout sets the type of storage used store the raw data for a dataset.static int
H5Pset_libver_bounds(int fapl_id, int low, int high)
H5Pset_libver_bounds Sets bounds on library versions, and indirectly format versions, to be used when creating objectsstatic int
H5Pset_link_creation_order(int gcpl_id, int crt_order_flags)
H5Pset_link_creation_order Sets flags in a group creation property list, gcpl_id, for tracking and/or indexing links on creation order.static int
H5Pset_link_phase_change(int gcpl_id, int max_compact, int min_dense)
H5Pset_link_phase_change Sets the parameters for conversion between compact and dense groups.static int
H5Pset_local_heap_size_hint(int gcpl_id, long size_hint)
H5Pset_local_heap_size_hint Specifies the anticipated maximum size of a local heap.static void
H5Pset_mdc_config(int plist_id, H5AC_cache_config_t config_ptr)
static void
H5Pset_meta_block_size(int fapl_id, long size)
H5Pset_meta_block_size sets the minimum metadata block size.static int
H5Pset_nbit(int plist_id)
H5Pset_nbit Sets up the use of the N-Bit filter.static int
H5Pset_nlinks(int lapl_id, long nlinks)
H5Pset_nlinks sets the maximum number of soft or user-defined link traversals allowed, nlinks, before the library assumes it has found a cycle and aborts the traversal.static void
H5Pset_obj_track_times(int ocpl_id, boolean track_times)
H5Pset_obj_track_times sets a property in the object creation property list, ocpl_id, that governs the recording of times associated with an object.static int
H5Pset_preserve(int plist, boolean status)
Deprecated.As of HDF5 1.8, compound datatype field preservation is now core functionality in the HDF5 Library.static int
H5Pset_scaleoffset(int plist_id, int scale_type, int scale_factor)
H5Pset_scaleoffset sets the Scale-Offset filter for a dataset.static int
H5Pset_shared_mesg_index(int fcpl_id, int index_num, int mesg_type_flags, int min_mesg_size)
H5Pset_shared_mesg_index Configures the specified shared object header message indexstatic int
H5Pset_shared_mesg_nindexes(int plist_id, int nindexes)
H5Pset_shared_mesg_nindexes sets the number of shared object header message indexes in the specified file creation property list.static int
H5Pset_shared_mesg_phase_change(int fcpl_id, int max_list, int min_btree)
H5Pset_shared_mesg_phase_change sets shared object header message storage phase change thresholds.static int
H5Pset_shuffle(int plist_id)
static void
H5Pset_sieve_buf_size(int fapl_id, long size)
static int
H5Pset_sizes(int plist, int sizeof_addr, int sizeof_size)
H5Pset_sizes sets the byte size of the offsets and lengths used to address objects in an HDF5 file.static int
H5Pset_small_data_block_size(int plist, long size)
H5Pset_small_data_block_size reserves blocks of size bytes for the contiguous storage of the raw data portion of small datasets.static int
H5Pset_sym_k(int plist, int ik, int lk)
H5Pset_sym_k sets the size of parameters used to control the symbol table nodes.static int
H5Pset_szip(int plist, int options_mask, int pixels_per_block)
static int
H5Pset_userblock(int plist, long size)
H5Pset_userblock sets the user block size of a file creation property list.static int
H5Punregister(int plid, java.lang.String name)
H5Punregister removes a property from a property list classstatic byte[]
H5Rcreate(int loc_id, java.lang.String name, int ref_type, int space_id)
H5Rcreate creates the reference, ref, of the type specified in ref_type, pointing to the object name located at loc_id.static int
H5Rdereference(int dataset, int ref_type, byte[] ref)
Given a reference to some object, H5Rdereference opens that object and return an identifier.static long
H5Rget_name(int loc_id, int ref_type, byte[] ref, java.lang.String[] name, long size)
H5Rget_name retrieves a name for the object identified by ref.static int
H5Rget_obj_type(int loc_id, int ref_type, byte[] ref)
Deprecated.As of HDF5 1.8, replaced byH5Rget_obj_type(int, int, byte[], int[])
static int
H5Rget_obj_type(int loc_id, int ref_type, byte[] ref, int[] obj_type)
H5Rget_obj_type Given a reference to an object ref, H5Rget_obj_type returns the type of the object pointed to.static int
H5Rget_region(int loc_id, int ref_type, byte[] ref)
Given a reference to an object ref, H5Rget_region creates a copy of the dataspace of the dataset pointed to and defines a selection in the copy which is the region pointed to.static int
H5Sclose(int space_id)
H5Sclose releases a dataspace.static int
H5Scopy(int space_id)
H5Scopy creates a new dataspace which is an exact copy of the dataspace identified by space_id.static int
H5Screate(int type)
H5Screate creates a new dataspace of a particular type.static int
H5Screate_simple(int rank, byte[] dims, byte[] maxdims)
Deprecated.use H5Screate_simple(int rank, long[] dims, long[] maxdims)static int
H5Screate_simple(int rank, long[] dims, long[] maxdims)
H5Screate_simple creates a new simple data space and opens it for access.static int
H5Sdecode(byte[] buf)
H5Sdecode reconstructs the HDF5 data space object and returns a new object handle for it.static byte[]
H5Sencode(int obj_id)
H5Sencode converts a data space description into binary form in a buffer.static int
H5set_free_list_limits(int reg_global_lim, int reg_list_lim, int arr_global_lim, int arr_list_lim, int blk_global_lim, int blk_list_lim)
static int
H5Sextent_copy(int dest_space_id, int source_space_id)
H5Sextent_copy copies the extent from source_space_id to dest_space_id.static boolean
H5Sextent_equal(int first_space_id, int second_space_id)
H5Sextent_equal determines whether the dataspace extents of two dataspaces, space1_id and space2_id, are equal.static int
H5Sget_select_bounds(int spaceid, long[] start, long[] end)
H5Sget_select_bounds retrieves the coordinates of the bounding box containing the current selection and places them into user-supplied buffers.static long
H5Sget_select_elem_npoints(int spaceid)
H5Sget_select_elem_npoints returns the number of element points in the current dataspace selection.static int
H5Sget_select_elem_pointlist(int spaceid, long startpoint, long numpoints, long[] buf)
H5Sget_select_elem_pointlist returns an array of of element points in the current dataspace selection.static int
H5Sget_select_hyper_blocklist(int spaceid, long startblock, long numblocks, long[] buf)
H5Sget_select_hyper_blocklist returns an array of hyperslab blocks.static long
H5Sget_select_hyper_nblocks(int spaceid)
H5Sget_select_hyper_nblocks returns the number of hyperslab blocks in the current dataspace selection.static long
H5Sget_select_npoints(int space_id)
H5Sget_select_npoints determines the number of elements in the current selection of a dataspace.static int
H5Sget_select_type(int space_id)
H5Sget_select_type retrieves the type of selection currently defined for the dataspace space_id.static int
H5Sget_simple_extent_dims(int space_id, long[] dims, long[] maxdims)
H5Sget_simple_extent_dims returns the size and maximum sizes of each dimension of a dataspace through the dims and maxdims parameters.static int
H5Sget_simple_extent_ndims(int space_id)
H5Sget_simple_extent_ndims determines the dimensionality (or rank) of a dataspace.static long
H5Sget_simple_extent_npoints(int space_id)
H5Sget_simple_extent_npoints determines the number of elements in a dataspace.static int
H5Sget_simple_extent_type(int space_id)
H5Sget_simple_extent_type queries a dataspace to determine the current class of a dataspace.static boolean
H5Sis_simple(int space_id)
H5Sis_simple determines whether a dataspace is a simple dataspace.static int
H5Soffset_simple(int space_id, byte[] offset)
H5Soffset_simple sets the offset of a simple dataspace space_id.static int
H5Soffset_simple(int space_id, long[] offset)
static int
H5Sselect_all(int space_id)
H5Sselect_all selects the entire extent of the dataspace space_id.static int
H5Sselect_elements(int space_id, int op, int num_elements, long[][] coord2D)
H5Sselect_elements selects array elements to be included in the selection for the space_id dataspace.static int
H5Sselect_hyperslab(int space_id, int op, byte[] start, byte[] stride, byte[] count, byte[] block)
H5Sselect_hyperslab selects a hyperslab region to add to the current selected region for the dataspace specified by space_id.static int
H5Sselect_hyperslab(int space_id, int op, long[] start, long[] stride, long[] count, long[] block)
static int
H5Sselect_none(int space_id)
H5Sselect_none resets the selection region for the dataspace space_id to include no elements.static boolean
H5Sselect_valid(int space_id)
H5Sselect_valid verifies that the selection for the dataspace.static int
H5Sset_extent_none(int space_id)
H5Sset_extent_none removes the extent from a dataspace and sets the type to H5S_NONE.static int
H5Sset_extent_simple(int space_id, int rank, byte[] current_size, byte[] maximum_size)
static int
H5Sset_extent_simple(int space_id, int rank, long[] current_size, long[] maximum_size)
H5Sset_extent_simple sets or resets the size of an existing dataspace.static int
H5Tarray_create(int base, int rank, int[] dims, int[] perms)
Deprecated.As of HDF5 1.8, replaced byH5Tarray_create(int, int, long[])
static int
H5Tarray_create(int base_id, int ndims, long[] dim)
H5Tarray_create creates a new array datatype object.static int
H5Tclose(int type_id)
H5Tclose releases a datatype.static int
H5Tcommit(int loc_id, java.lang.String name, int type_id)
Deprecated.As of HDF5 1.8, replaced byH5Tcommit(int, String, int, int, int, int)
static void
H5Tcommit(int loc_id, java.lang.String name, int type_id, int lcpl_id, int tcpl_id, int tapl_id)
H5Tcommit saves a transient datatype as an immutable named datatype in a file.static void
H5Tcommit_anon(int loc_id, int type_id, int tcpl_id, int tapl_id)
H5Tcommit_anon commits a transient datatype (not immutable) to a file, turning it into a named datatype with the specified creation and property lists.static int
H5Tcommit1(int loc_id, java.lang.String name, int type)
Deprecated.static boolean
H5Tcommitted(int type_id)
H5Tcommitted queries a type to determine whether the type specified by the type identifier is a named type or a transient type.static void
H5Tcompiler_conv(int src_id, int dst_id)
H5Tcompiler_conv finds out whether the library's conversion function from type src_id to type dst_id is a compiler (hard) conversion.static void
H5Tconvert(int src_id, int dst_id, long nelmts, byte[] buf, byte[] background, int plist_id)
H5Tconvert converts nelmts elements from the type specified by the src_id identifier to type dst_id.static int
H5Tcopy(int type_id)
H5Tcopy copies an existing datatype.static int
H5Tcreate(int dclass, int size)
H5Tcreate creates a new dataype of the specified class with the specified number of bytes.static int
H5Tcreate(int tclass, long size)
H5Tcreate creates a new dataype of the specified class with the specified number of bytes.static int
H5Tdecode(byte[] buf)
H5Tdecode reconstructs the HDF5 data type object and returns a new object handle for it.static boolean
H5Tdetect_class(int type_id, int cls)
H5Tdetect_class determines whether the datatype specified in dtype_id contains any datatypes of the datatype class specified in dtype_class.static int
H5Tencode(int obj_id, byte[] buf, long nalloc)
H5Tencode converts a data type description into binary form in a buffer.static int
H5Tenum_create(int base_id)
H5Tenum_create creates a new enumeration datatype based on the specified base datatype, parent_id, which must be an integer type.static void
H5Tenum_insert(int type, java.lang.String name, byte[] value)
H5Tenum_insert inserts a new enumeration datatype member into an enumeration datatype.static int
H5Tenum_insert(int type, java.lang.String name, int value)
static int
H5Tenum_insert(int type, java.lang.String name, int[] value)
H5Tenum_insert inserts a new enumeration datatype member into an enumeration datatype.static java.lang.String
H5Tenum_nameof(int type, byte[] value, long size)
H5Tenum_nameof finds the symbol name that corresponds to the specified value of the enumeration datatype type.static int
H5Tenum_nameof(int type, int[] value, java.lang.String[] name, int size)
H5Tenum_nameof finds the symbol name that corresponds to the specified value of the enumeration datatype type.static void
H5Tenum_valueof(int type, java.lang.String name, byte[] value)
H5Tenum_valueof finds the value that corresponds to the specified name of the enumeration datatype type.static int
H5Tenum_valueof(int type, java.lang.String name, int[] value)
H5Tenum_valueof finds the value that corresponds to the specified name of the enumeration datatype type.static boolean
H5Tequal(int type_id1, int type_id2)
H5Tequal determines whether two datatype identifiers refer to the same datatype.static int
H5Tget_array_dims(int type_id, int[] dims, int[] perm)
Deprecated.As of HDF5 1.8static int
H5Tget_array_dims(int type_id, long[] dims)
H5Tget_array_dims returns the sizes of the dimensions of the specified array datatype object.static int
H5Tget_array_dims(int type_id, long[] dims, int[] perm)
Deprecated.As of HDF5 1.8, replaced byH5Tget_array_dims(int, long[])
static int
H5Tget_array_dims2(int type_id, long[] dims)
H5Tget_array_dims2 returns the sizes of the dimensions of the specified array datatype object.static int
H5Tget_array_ndims(int type_id)
H5Tget_array_ndims returns the rank, the number of dimensions, of an array datatype object.static int
H5Tget_class(int type_id)
H5Tget_class returns the datatype class identifier.static java.lang.String
H5Tget_class_name(int class_id)
H5Tget_class_name returns the datatype class identifier.static int
H5Tget_create_plist(int type_id)
H5Tget_create_plist returns a property list identifier for the datatype creation property list associated with the datatype specified by type_id.static int
H5Tget_cset(int type_id)
H5Tget_cset retrieves the character set type of a string datatype.static int
H5Tget_ebias(int type_id)
H5Tget_ebias retrieves the exponent bias of a floating-point type.static long
H5Tget_ebias_long(int type_id)
H5Tget_ebias retrieves the exponent bias of a floating-point type.static int
H5Tget_fields(int type_id, int[] fields)
H5Tget_fields retrieves information about the locations of the various bit fields of a floating point datatype.static void
H5Tget_fields(int type_id, long[] fields)
H5Tget_fields retrieves information about the locations of the various bit fields of a floating point datatype.static int
H5Tget_inpad(int type_id)
H5Tget_inpad retrieves the internal padding type for unused bits in floating-point datatypes.static int
H5Tget_member_class(int type_id, int membno)
H5Tget_member_class returns the class of datatype of the specified member.static int
H5Tget_member_index(int type_id, java.lang.String field_name)
H5Tget_member_index retrieves the index of a field of a compound datatype.static java.lang.String
H5Tget_member_name(int type_id, int field_idx)
H5Tget_member_name retrieves the name of a field of a compound datatype or an element of an enumeration datatype.static long
H5Tget_member_offset(int type_id, int membno)
H5Tget_member_offset returns the byte offset of the specified member of the compound datatype.static int
H5Tget_member_type(int type_id, int field_idx)
H5Tget_member_type returns the datatype of the specified member.static void
H5Tget_member_value(int type_id, int membno, byte[] value)
H5Tget_member_value returns the value of the enumeration datatype member memb_no.static int
H5Tget_member_value(int type_id, int membno, int[] value)
H5Tget_member_value returns the value of the enumeration datatype member memb_no.static int
H5Tget_native_type(int type_id)
H5Tget_native_type returns the equivalent native datatype for the datatype specified in type_id.static int
H5Tget_native_type(int type_id, int direction)
H5Tget_native_type returns the equivalent native datatype for the datatype specified in type_id.static int
H5Tget_nmembers(int type_id)
H5Tget_nmembers retrieves the number of fields a compound datatype has.static int
H5Tget_norm(int type_id)
H5Tget_norm retrieves the mantissa normalization of a floating-point datatype.static int
H5Tget_offset(int type_id)
H5Tget_offset retrieves the bit offset of the first significant bit.static int
H5Tget_order(int type_id)
H5Tget_order returns the byte order of an atomic datatype.static int
H5Tget_pad(int type_id, int[] pad)
H5Tget_pad retrieves the padding type of the least and most-significant bit padding.static int
H5Tget_precision(int type_id)
H5Tget_precision returns the precision of an atomic datatype.static long
H5Tget_precision_long(int type_id)
H5Tget_precision returns the precision of an atomic datatype.static int
H5Tget_sign(int type_id)
H5Tget_sign retrieves the sign type for an integer type.static int
H5Tget_size(int type_id)
H5Tget_size returns the size of a datatype in bytes.static long
H5Tget_size_long(int type_id)
H5Tget_size returns the size of a datatype in bytes.static int
H5Tget_strpad(int type_id)
H5Tget_strpad retrieves the string padding method for a string datatype.static int
H5Tget_super(int type)
H5Tget_super returns the type from which TYPE is derived.static java.lang.String
H5Tget_tag(int type)
H5Tget_tag returns the tag associated with datatype type_id.static int
H5Tinsert(int type_id, java.lang.String name, long offset, int field_id)
H5Tinsert adds another member to the compound datatype type_id.static boolean
H5Tis_variable_str(int type_id)
H5Tis_variable_str determines whether the datatype identified in type_id is a variable-length string.static int
H5Tlock(int type_id)
H5Tlock locks the datatype specified by the type_id identifier, making it read-only and non-destrucible.static int
H5Topen(int loc_id, java.lang.String name)
Deprecated.As of HDF5 1.8, replaced byH5Topen(int, String, int)
static int
H5Topen(int loc_id, java.lang.String name, int tapl_id)
H5Topen opens a named datatype at the location specified by loc_id and return an identifier for the datatype.static int
H5Tpack(int type_id)
H5Tpack recursively removes padding from within a compound datatype to make it more efficient (space-wise) to store that data.static int
H5Tset_cset(int type_id, int cset)
H5Tset_cset the character set to be used.static int
H5Tset_ebias(int type_id, int ebias)
H5Tset_ebias sets the exponent bias of a floating-point type.static void
H5Tset_ebias(int type_id, long ebias)
H5Tset_ebias sets the exponent bias of a floating-point type.static int
H5Tset_fields(int type_id, int spos, int epos, int esize, int mpos, int msize)
H5Tset_fields sets the locations and sizes of the various floating point bit fields.static void
H5Tset_fields(int type_id, long spos, long epos, long esize, long mpos, long msize)
H5Tset_fields sets the locations and sizes of the various floating point bit fields.static int
H5Tset_inpad(int type_id, int inpad)
If any internal bits of a floating point type are unused (that is, those significant bits which are not part of the sign, exponent, or mantissa), then H5Tset_inpad will be filled according to the value of the padding value property inpad.static int
H5Tset_norm(int type_id, int norm)
H5Tset_norm sets the mantissa normalization of a floating-point datatype.static int
H5Tset_offset(int type_id, int offset)
H5Tset_offset sets the bit offset of the first significant bit.static void
H5Tset_offset(int type_id, long offset)
H5Tset_offset sets the bit offset of the first significant bit.static int
H5Tset_order(int type_id, int order)
H5Tset_order sets the byte ordering of an atomic datatype.static int
H5Tset_pad(int type_id, int lsb, int msb)
H5Tset_pad sets the least and most-significant bits padding types.static int
H5Tset_precision(int type_id, int precision)
H5Tset_precision sets the precision of an atomic datatype.static void
H5Tset_precision(int type_id, long precision)
H5Tset_precision sets the precision of an atomic datatype.static int
H5Tset_sign(int type_id, int sign)
H5Tset_sign sets the sign proprety for an integer type.static int
H5Tset_size(int type_id, int size)
H5Tset_size sets the total size in bytes, size, for an atomic datatype (this operation is not permitted on compound datatypes).static void
H5Tset_size(int type_id, long size)
H5Tset_size sets the total size in bytes, size, for an atomic datatype (this operation is not permitted on compound datatypes).static int
H5Tset_strpad(int type_id, int strpad)
H5Tset_strpad defines the storage mechanism for the string.static int
H5Tset_tag(int type, java.lang.String tag)
H5Tset_tag tags an opaque datatype type_id with a unique ASCII identifier tag.static int
H5Tvlen_create(int base_id)
H5Tvlen_create creates a new variable-length (VL) dataype.static int
H5Zfilter_avail(int filter)
static int
H5Zget_filter_info(int filter)
static int
H5Zunregister(int filter)
static void
loadH5Lib()
-
-
-
Field Detail
-
LIB_VERSION
public static final int[] LIB_VERSION
The version number of the HDF5 library: LIB_VERSION[0]: The major version of the library. LIB_VERSION[1]: The minor version of the library. LIB_VERSION[2]: The release number of the library. Make sure to update the versions number when a different library is used.
-
H5PATH_PROPERTY_KEY
public static final java.lang.String H5PATH_PROPERTY_KEY
- See Also:
- Constant Field Values
-
H5_LIBRARY_NAME_PROPERTY_KEY
public static final java.lang.String H5_LIBRARY_NAME_PROPERTY_KEY
- See Also:
- Constant Field Values
-
-
Method Detail
-
loadH5Lib
public static void loadH5Lib()
-
getOpenIDCount
public static final int getOpenIDCount()
Get number of open IDs.- Returns:
- Returns a count of open IDs
-
getOpenID
@Deprecated public static final int getOpenID(int index)
Deprecated.This no longer returns useful information due to internal code changes.Get the open ID at the specified index. Always returns -1. To iterate over the set of open IDs, use the getOpenIDs method and use an iterator.- Parameters:
index
- -- an index of the open ID.- Returns:
- Always returns -1.
-
getOpenIDs
public static final java.util.Collection<java.lang.Integer> getOpenIDs()
Get the open IDs- Returns:
- Returns a collection of open IDs
-
H5check_version
public static int H5check_version(int majnum, int minnum, int relnum)
H5check_version verifies that the arguments match the version numbers compiled into the library.- Parameters:
majnum
- The major version of the library.minnum
- The minor version of the library.relnum
- The release number of the library.- Returns:
- a non-negative value if successful. Upon failure (when the versions do not match), this function causes the application to abort (i.e., crash) See C API function: herr_t H5check_version()
-
H5close
public static int H5close() throws HDF5LibraryException
H5close flushes all data to disk, closes all file identifiers, and cleans up all memory used by the library.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5open
public static int H5open() throws HDF5LibraryException
H5open initialize the library.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5error_off
public static int H5error_off()
Turn off error handling By default, the C library prints the error stack of the HDF-5 C library on stdout. This behavior may be disabled by calling H5error_off().- Returns:
- a non-negative value if successful
-
H5garbage_collect
public static int H5garbage_collect() throws HDF5LibraryException
H5garbage_collect collects on all free-lists of all types.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5get_libversion
public static int H5get_libversion(int[] libversion) throws HDF5LibraryException
H5get_libversion retrieves the major, minor, and release numbers of the version of the HDF library which is linked to the application.- Parameters:
libversion
- The version information of the HDF library.libversion[0] = The major version of the library. libversion[1] = The minor version of the library. libversion[2] = The release number of the library.
- Returns:
- a non-negative value if successful, along with the version information.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5set_free_list_limits
public static int H5set_free_list_limits(int reg_global_lim, int reg_list_lim, int arr_global_lim, int arr_list_lim, int blk_global_lim, int blk_list_lim) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5export_dataset
public static void H5export_dataset(java.lang.String file_export_name, java.lang.String file_name, java.lang.String object_path, int binary_order) throws HDF5LibraryException
H5export_dataset is a utility function to save data in a file.- Parameters:
file_export_name
- The file name to export data into.file_name
- The name of the HDF5 file containing the dataset.object_path
- The full path of the dataset to be exported.binary_order
- 99 - export data as text. 1 - export data as binary Native Order. 2 - export data as binary Little Endian. 3 - export data as binary Big Endian.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Aclose
public static int H5Aclose(int attr_id) throws HDF5LibraryException
H5Aclose terminates access to the attribute specified by its identifier, attr_id.- Parameters:
attr_id
- IN: Attribute to release access to.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Acopy
public static int H5Acopy(int src_aid, int dst_aid) throws HDF5LibraryException
H5Acopy copies the content of one attribute to another.- Parameters:
src_aid
- the identifier of the source attributedst_aid
- the identifier of the destination attribute- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Acreate
@Deprecated public static int H5Acreate(int loc_id, java.lang.String name, int type_id, int space_id, int create_plist) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Acreate(int, String, int, int, int, int)
H5Acreate creates an attribute which is attached to the object specified with loc_id.- Parameters:
loc_id
- IN: Object (dataset, group, or named datatype) to be attached to.name
- IN: Name of attribute to create.type_id
- IN: Identifier of datatype for attribute.space_id
- IN: Identifier of dataspace for attribute.create_plist
- IN: Identifier of creation property list (currently not used).- Returns:
- an attribute identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Acreate
public static int H5Acreate(int loc_id, java.lang.String attr_name, int type_id, int space_id, int acpl_id, int aapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Acreate creates an attribute, attr_name, which is attached to the object specified by the identifier loc_id.- Parameters:
loc_id
- IN: Location or object identifier; may be dataset or groupattr_name
- IN: Attribute nametype_id
- IN: Attribute datatype identifierspace_id
- IN: Attribute dataspace identifieracpl_id
- IN: Attribute creation property list identifieraapl_id
- IN: Attribute access property list identifier- Returns:
- An attribute identifier if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - Name is null.
-
H5Acreate_by_name
public static int H5Acreate_by_name(int loc_id, java.lang.String obj_name, java.lang.String attr_name, int type_id, int space_id, int acpl_id, int aapl_id, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Acreate_by_name creates an attribute, attr_name, which is attached to the object specified by loc_id and obj_name.- Parameters:
loc_id
- IN: Location or object identifier; may be dataset or groupobj_name
- IN: Name, relative to loc_id, of object that attribute is to be attached toattr_name
- IN: Attribute nametype_id
- IN: Attribute datatype identifierspace_id
- IN: Attribute dataspace identifieracpl_id
- IN: Attribute creation property list identifier (currently not used).aapl_id
- IN: Attribute access property list identifier (currently not used).lapl_id
- IN: Link access property list- Returns:
- An attribute identifier if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Adelete
public static int H5Adelete(int loc_id, java.lang.String name) throws HDF5LibraryException, java.lang.NullPointerException
H5Adelete removes the attribute specified by its name, name, from a dataset, group, or named datatype.- Parameters:
loc_id
- IN: Identifier of the dataset, group, or named datatype.name
- IN: Name of the attribute to delete.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Adelete_by_idx
public static void H5Adelete_by_idx(int loc_id, java.lang.String obj_name, int idx_type, int order, long n, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Adelete_by_idx removes an attribute, specified by its location in an index, from an object.- Parameters:
loc_id
- IN: Location or object identifier; may be dataset or groupobj_name
- IN: Name of object, relative to location, from which attribute is to be removedidx_type
- IN: Type of indexorder
- IN: Order in which to iterate over indexn
- IN: Offset within indexlapl_id
- IN: Link access property list identifier- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - obj_name is null.
-
H5Adelete_by_name
public static int H5Adelete_by_name(int loc_id, java.lang.String obj_name, java.lang.String attr_name, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Adelete_by_name removes the attribute attr_name from an object specified by location and name, loc_id and obj_name, respectively.- Parameters:
loc_id
- IN: Location or object identifier; may be dataset or groupobj_name
- IN: Name of object, relative to location, from which attribute is to be removedattr_name
- IN: Name of attribute to deletelapl_id
- IN: Link access property list identifier.- Returns:
- a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Aexists
public static boolean H5Aexists(int obj_id, java.lang.String attr_name) throws HDF5LibraryException, java.lang.NullPointerException
H5Aexists determines whether the attribute attr_name exists on the object specified by obj_id.- Parameters:
obj_id
- IN: Object identifier.attr_name
- IN: Name of the attribute.- Returns:
- boolean true if an attribute with a given name exists.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - attr_name is null.
-
H5Aexists_by_name
public static boolean H5Aexists_by_name(int loc_id, java.lang.String obj_name, java.lang.String attr_name, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Aexists_by_name determines whether the attribute attr_name exists on an object. That object is specified by its location and name, loc_id and obj_name, respectively.- Parameters:
loc_id
- IN: Location of object to which attribute is attached .obj_name
- IN: Name, relative to loc_id, of object that attribute is attached to.attr_name
- IN: Name of attribute.lapl_id
- IN: Link access property list identifier.- Returns:
- boolean true if an attribute with a given name exists, otherwise returns false.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Aget_info
public static H5A_info_t H5Aget_info(int attr_id) throws HDF5LibraryException
H5Aget_info retrieves attribute information, by attribute identifier.- Parameters:
attr_id
- IN: Attribute identifier- Returns:
- A buffer(H5A_info_t) for Attribute information
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Aget_info_by_idx
public static H5A_info_t H5Aget_info_by_idx(int loc_id, java.lang.String obj_name, int idx_type, int order, long n, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Aget_info_by_idx Retrieves attribute information, by attribute index position.- Parameters:
loc_id
- IN: Location of object to which attribute is attachedobj_name
- IN: Name of object to which attribute is attached, relative to locationidx_type
- IN: Type of indexorder
- IN: Index traversal ordern
- IN: Attribute's position in indexlapl_id
- IN: Link access property list- Returns:
- A buffer(H5A_info_t) for Attribute information
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - obj_name is null.
-
H5Aget_info_by_name
public static H5A_info_t H5Aget_info_by_name(int loc_id, java.lang.String obj_name, java.lang.String attr_name, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Aget_info_by_name Retrieves attribute information, by attribute name.- Parameters:
loc_id
- IN: Location of object to which attribute is attachedobj_name
- IN: Name of object to which attribute is attached, relative to locationattr_name
- IN: Attribute namelapl_id
- IN: Link access property list- Returns:
- A buffer(H5A_info_t) for Attribute information
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - obj_name is null.
-
H5Aget_name
public static java.lang.String H5Aget_name(int attr_id) throws HDF5LibraryException
H5Aget_name retrieves the name of an attribute specified by the identifier, attr_id.- Parameters:
attr_id
- IN: Identifier of the attribute.- Returns:
- String for Attribute name.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Aget_name_by_idx
public static java.lang.String H5Aget_name_by_idx(int attr_id, java.lang.String obj_name, int idx_type, int order, long n, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Aget_name_by_idx retrieves the name of an attribute that is attached to an object, which is specified by its location and name, loc_id and obj_name, respectively.- Parameters:
attr_id
- IN: Attribute identifierobj_name
- IN: Name of object to which attribute is attached, relative to locationidx_type
- IN: Type of indexorder
- IN: Index traversal ordern
- IN: Attribute's position in indexlapl_id
- IN: Link access property list- Returns:
- String for Attribute name.
- Throws:
HDF5LibraryException
- - Error from the HDF5 Library.java.lang.NullPointerException
- - obj_name is null.
-
H5Aget_num_attrs
@Deprecated public static int H5Aget_num_attrs(int loc_id) throws HDF5LibraryException
Deprecated.As of HDF5 1.8, replaced byH5Oget_info(int )
H5Aget_num_attrs returns the number of attributes attached to the object specified by its identifier, loc_id.- Parameters:
loc_id
- IN: Identifier of a group, dataset, or named datatype.- Returns:
- the number of attributes if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Aget_space
public static int H5Aget_space(int attr_id) throws HDF5LibraryException
H5Aget_space retrieves a copy of the dataspace for an attribute.- Parameters:
attr_id
- IN: Identifier of an attribute.- Returns:
- attribute dataspace identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Aget_storage_size
public static long H5Aget_storage_size(int attr_id) throws HDF5LibraryException
H5Aget_storage_size returns the amount of storage that is required for the specified attribute, attr_id.- Parameters:
attr_id
- IN: Identifier of the attribute to query.- Returns:
- the amount of storage size allocated for the attribute; otherwise returns 0 (zero)
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Aget_type
public static int H5Aget_type(int attr_id) throws HDF5LibraryException
H5Aget_type retrieves a copy of the datatype for an attribute.- Parameters:
attr_id
- IN: Identifier of an attribute.- Returns:
- a datatype identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Aopen
public static int H5Aopen(int obj_id, java.lang.String attr_name, int aapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Aopen opens an existing attribute, attr_name, that is attached to an object specified an object identifier, object_id.- Parameters:
obj_id
- IN: Identifier for object to which attribute is attachedattr_name
- IN: Name of attribute to openaapl_id
- IN: Attribute access property list identifier- Returns:
- An attribute identifier if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - Name is null.
-
H5Aopen_by_idx
public static int H5Aopen_by_idx(int loc_id, java.lang.String obj_name, int idx_type, int order, long n, int aapl_id, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Aopen_by_idx opens an existing attribute that is attached to an object specified by location and name, loc_id and obj_name, respectively- Parameters:
loc_id
- IN: Location of object to which attribute is attachedobj_name
- IN: Name of object to which attribute is attached, relative to locationidx_type
- IN: Type of indexorder
- IN: Index traversal ordern
- IN: Attribute's position in indexaapl_id
- IN: Attribute access property listlapl_id
- IN: Link access property list- Returns:
- An attribute identifier if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - Name is null.
-
H5Aopen_by_name
public static int H5Aopen_by_name(int loc_id, java.lang.String obj_name, java.lang.String attr_name, int aapl_id, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Aopen_by_name Opens an attribute for an object by object name and attribute name- Parameters:
loc_id
- IN: Location from which to find object to which attribute is attachedobj_name
- IN: Name of object to which attribute is attached, relative to loc_idattr_name
- IN: Name of attribute to openaapl_id
- IN: Attribute access property listlapl_id
- IN: Link access property list identifier- Returns:
- Returns an attribute identifier if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - obj_name is null.
-
H5Aopen_idx
@Deprecated public static int H5Aopen_idx(int loc_id, int idx) throws HDF5LibraryException
Deprecated.As of HDF5 1.8, replaced byH5Aopen_by_idx(int, String, int, int, long, int, int)
H5Aopen_idx opens an attribute which is attached to the object specified with loc_id. The location object may be either a group, dataset, or named datatype, all of which may have any sort of attribute.- Parameters:
loc_id
- IN: Identifier of the group, dataset, or named datatype attributeidx
- IN: Index of the attribute to open.- Returns:
- attribute identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Aopen_name
@Deprecated public static int H5Aopen_name(int loc_id, java.lang.String name) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Aopen_by_name(int, String, String, int, int)
H5Aopen_name opens an attribute specified by its name, name, which is attached to the object specified with loc_id.- Parameters:
loc_id
- IN: Identifier of a group, dataset, or named datatype atttributename
- IN: Attribute name.- Returns:
- attribute identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Aread
public static int H5Aread(int attr_id, int mem_type_id, byte[] buf) throws HDF5LibraryException, java.lang.NullPointerException
H5Aread reads an attribute, specified with attr_id. The attribute's memory datatype is specified with mem_type_id. The entire attribute is read into buf from the file.- Parameters:
attr_id
- IN: Identifier of an attribute to read.mem_type_id
- IN: Identifier of the attribute datatype (in memory).buf
- IN: Buffer for data to be read.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - data buffer is null.
-
H5Aread
public static int H5Aread(int attr_id, int mem_type_id, java.lang.Object obj) throws HDF5Exception, java.lang.NullPointerException
H5Aread reads an attribute, specified with attr_id. The attribute's memory datatype is specified with mem_type_id. The entire attribute is read into data object from the file.- Parameters:
attr_id
- IN: Identifier of an attribute to read.mem_type_id
- IN: Identifier of the attribute datatype (in memory).obj
- IN: Object for data to be read.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - data buffer is null. See public synchronized static native int H5Aread( )HDF5Exception
-
H5AreadVL
public static int H5AreadVL(int attr_id, int mem_type_id, java.lang.String[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5AreadComplex
public static int H5AreadComplex(int attr_id, int mem_type_id, java.lang.String[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Arename
public static int H5Arename(int loc_id, java.lang.String old_attr_name, java.lang.String new_attr_name) throws HDF5LibraryException, java.lang.NullPointerException
H5Arename changes the name of attribute that is attached to the object specified by loc_id. The attribute named old_attr_name is renamed new_attr_name.- Parameters:
loc_id
- IN: Location or object identifier; may be dataset or groupold_attr_name
- IN: Prior attribute namenew_attr_name
- IN: New attribute name- Returns:
- A non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - Name is null.
-
H5Arename_by_name
public static int H5Arename_by_name(int loc_id, java.lang.String obj_name, java.lang.String old_attr_name, java.lang.String new_attr_name, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Arename_by_name changes the name of attribute that is attached to the object specified by loc_id and obj_name. The attribute named old_attr_name is renamed new_attr_name.- Parameters:
loc_id
- IN: Location or object identifier; may be dataset or groupobj_name
- IN: Name of object, relative to location, whose attribute is to be renamedold_attr_name
- IN: Prior attribute namenew_attr_name
- IN: New attribute namelapl_id
- IN: Link access property list- Returns:
- A non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - Name is null.
-
H5Awrite
public static int H5Awrite(int attr_id, int mem_type_id, byte[] buf) throws HDF5LibraryException, java.lang.NullPointerException
H5Awrite writes an attribute, specified with attr_id. The attribute's memory datatype is specified with mem_type_id. The entire attribute is written from buf to the file.- Parameters:
attr_id
- IN: Identifier of an attribute to write.mem_type_id
- IN: Identifier of the attribute datatype (in memory).buf
- IN: Data to be written.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - data is null.
-
H5Awrite
public static int H5Awrite(int attr_id, int mem_type_id, java.lang.Object obj) throws HDF5Exception, java.lang.NullPointerException
H5Awrite writes an attribute, specified with attr_id. The attribute's memory datatype is specified with mem_type_id. The entire attribute is written from data object to the file.- Parameters:
attr_id
- IN: Identifier of an attribute to write.mem_type_id
- IN: Identifier of the attribute datatype (in memory).obj
- IN: Data object to be written.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - data object is null. See public synchronized static native int H5Awrite(int attr_id, int mem_type_id, byte[] buf);HDF5Exception
-
H5AwriteVL
public static int H5AwriteVL(int attr_id, int mem_type_id, java.lang.String[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Aget_create_plist
public static int H5Aget_create_plist(int attr_id) throws HDF5LibraryException
H5Aget_create_plist retrieves a copy of the attribute creation property list identifier.- Parameters:
attr_id
- IN: Identifier of an attribute.- Returns:
- identifier for the attribute's creation property list if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Aiterate
public static int H5Aiterate(int loc_id, int idx_type, int order, long idx, H5A_iterate_cb op, H5A_iterate_t op_data) throws HDF5LibraryException, java.lang.NullPointerException
H5Aiterate2 iterates over the attributes attached to a dataset, named datatype, or group, as specified by obj_id. For each attribute, user-provided data, op_data, with additional information as defined below, is passed to a user-defined function, op, which operates on that attribute.- Parameters:
loc_id
- IN: Identifier for object to which attributes are attached; may be group, dataset, or named datatype.idx_type
- IN: The type of index specified by idx_type can be one of the following: H5_INDEX_NAME An alpha-numeric index by attribute name. H5_INDEX_CRT_ORDER An index by creation order.order
- IN: The order in which the index is to be traversed, as specified by order, can be one of the following: H5_ITER_INC Iteration is from beginning to end, i.e., a top-down iteration incrementing the index position at each step. H5_ITER_DEC Iteration starts at the end of the index, i.e., a bottom-up iteration decrementing the index position at each step. H5_ITER_NATIVE HDF5 iterates in the fastest-available order. No information is provided as to the order, but HDF5 ensures that each element in the index will be visited if the iteration completes successfully.idx
- IN/OUT: Initial and returned offset within index.op
- IN: Callback function to operate on each value.op_data
- IN/OUT: Pointer to any user-efined data for use by operator function.- Returns:
- returns the return value of the first operator that returns a positive value, or zero if all members were processed with no operator returning non-zero.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - buf is null.
-
H5Aiterate_by_name
public static int H5Aiterate_by_name(int loc_id, java.lang.String obj_name, int idx_type, int order, long idx, H5A_iterate_cb op, H5A_iterate_t op_data, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Aiterate_by_name iterates over the attributes attached to the dataset or group specified with loc_id and obj_name. For each attribute, user-provided data, op_data, with additional information as defined below, is passed to a user-defined function, op, which operates on that attribute.- Parameters:
loc_id
- IN: Identifier for object to which attributes are attached; may be group, dataset, or named datatype.obj_name
- IN: Name of object, relative to location.idx_type
- IN: The type of index specified by idx_type can be one of the following: H5_INDEX_NAME An alpha-numeric index by attribute name. H5_INDEX_CRT_ORDER An index by creation order.order
- IN: The order in which the index is to be traversed, as specified by order, can be one of the following: H5_ITER_INC Iteration is from beginning to end, i.e., a top-down iteration incrementing the index position at each step. H5_ITER_DEC Iteration starts at the end of the index, i.e., a bottom-up iteration decrementing the index position at each step. H5_ITER_NATIVE HDF5 iterates in the fastest-available order. No information is provided as to the order, but HDF5 ensures that each element in the index will be visited if the iteration completes successfully.idx
- IN/OUT: Initial and returned offset within index.op
- IN: Callback function to operate on each value.op_data
- IN/OUT: Pointer to any user-efined data for use by operator function.lapl_id
- IN: Link access property list- Returns:
- returns the return value of the first operator that returns a positive value, or zero if all members were processed with no operator returning non-zero.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - buf is null.
-
H5Dcopy
public static int H5Dcopy(int src_did, int dst_did) throws HDF5LibraryException
H5Dcopy copies the content of one dataset to another dataset.- Parameters:
src_did
- the identifier of the source datasetdst_did
- the identifier of the destinaiton dataset- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Dclose
public static int H5Dclose(int dataset_id) throws HDF5LibraryException
H5Dclose ends access to a dataset specified by dataset_id and releases resources used by it.- Parameters:
dataset_id
- Identifier of the dataset to finish access to.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Dcreate
@Deprecated public static int H5Dcreate(int loc_id, java.lang.String name, int type_id, int space_id, int create_plist_id) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Dcreate(int, String, int, int, int, int, int)
H5Dcreate creates a data set with a name, name, in the file or in the group specified by the identifier loc_id.- Parameters:
loc_id
- Identifier of the file or group to create the dataset within.name
- The name of the dataset to create.type_id
- Identifier of the datatype to use when creating the dataset.space_id
- Identifier of the dataspace to use when creating the dataset.create_plist_id
- Identifier of the set creation property list.- Returns:
- a dataset identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Dcreate
public static int H5Dcreate(int loc_id, java.lang.String name, int type_id, int space_id, int lcpl_id, int dcpl_id, int dapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Dcreate creates a new dataset named name at the location specified by loc_id.- Parameters:
loc_id
- IN: Location identifiername
- IN: Dataset nametype_id
- IN: Datatype identifierspace_id
- IN: Dataspace identifierlcpl_id
- IN: Identifier of link creation property list.dcpl_id
- IN: Identifier of dataset creation property list.dapl_id
- IN: Identifier of dataset access property list.- Returns:
- a dataset identifier
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Dcreate_anon
public static int H5Dcreate_anon(int loc_id, int type_id, int space_id, int dcpl_id, int dapl_id) throws HDF5LibraryException
H5Dcreate_anon creates a dataset in the file specified by loc_id.- Parameters:
loc_id
- IN: Location identifiertype_id
- IN: Datatype identifierspace_id
- IN: Dataspace identifierdcpl_id
- IN: Identifier of dataset creation property list.dapl_id
- IN: Identifier of dataset access property list.- Returns:
- a dataset identifier
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Dextend
@Deprecated public static int H5Dextend(int dataset_id, byte[] size) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Dset_extent(int, long[])
H5Dextend verifies that the dataset is at least of size size.- Parameters:
dataset_id
- IN: Identifier of the dataset.size
- IN: Array containing the new magnitude of each dimension.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - size array is null.
-
H5Dextend
@Deprecated public static int H5Dextend(int dataset_id, long[] size) throws HDF5Exception, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Dset_extent(int, long[])
H5Dextend verifies that the dataset is at least of size size.- Parameters:
dataset_id
- IN: Identifier of the dataset.size
- IN: Array containing the new magnitude of each dimension.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - size array is null.HDF5Exception
-
H5Dfill
public static void H5Dfill(byte[] fill, int fill_type, byte[] buf, int buf_type, int space_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Dfill explicitly fills the dataspace selection in memory, space_id, with the fill value specified in fill.- Parameters:
fill
- IN: Pointer to the fill value to be used.fill_type
- IN: Fill value datatype identifier.buf
- IN/OUT: Pointer to the memory buffer containing the selection to be filled.buf_type
- IN: Datatype of dataspace elements to be filled.space_id
- IN: Dataspace describing memory buffer and containing the selection to be filled.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - buf is null.
-
H5Dget_access_plist
public static int H5Dget_access_plist(int dset_id) throws HDF5LibraryException
H5Dget_access_plist returns an identifier for a copy of the dataset access property list for a dataset.- Parameters:
dset_id
- IN: Identifier of the dataset to query.- Returns:
- a dataset access property list identifier
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Dget_create_plist
public static int H5Dget_create_plist(int dataset_id) throws HDF5LibraryException
H5Dget_create_plist returns an identifier for a copy of the dataset creation property list for a dataset.- Parameters:
dataset_id
- Identifier of the dataset to query.- Returns:
- a dataset creation property list identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Dget_offset
public static long H5Dget_offset(int dset_id) throws HDF5LibraryException
H5Dget_offset returns the address in the file of the dataset dset_id.- Parameters:
dset_id
- IN: Identifier of the dataset in question- Returns:
- the offset in bytes.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Dget_space
public static int H5Dget_space(int dataset_id) throws HDF5LibraryException
H5Dget_space returns an identifier for a copy of the dataspace for a dataset.- Parameters:
dataset_id
- Identifier of the dataset to query.- Returns:
- a dataspace identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Dget_space_status
public static int H5Dget_space_status(int dset_id) throws HDF5LibraryException
H5Dget_space_status determines whether space has been allocated for the dataset dset_id.- Parameters:
dset_id
- IN: Identifier of the dataset to query.- Returns:
- the space allocation status
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Dget_space_status
public static int H5Dget_space_status(int dset_id, int[] status) throws HDF5LibraryException, java.lang.NullPointerException
H5Dget_space_status determines whether space has been allocated for the dataset dset_id.- Parameters:
dset_id
- IN: Identifier of the dataset to query.status
- OUT: the space allocation status- Returns:
- non-negative if succeed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
-
H5Dget_storage_size
public static long H5Dget_storage_size(int dataset_id) throws HDF5LibraryException, java.lang.IllegalArgumentException
H5Dget_storage_size returns the amount of storage that is required for the dataset.- Parameters:
dataset_id
- Identifier of the dataset in question- Returns:
- he amount of storage space allocated for the dataset.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.IllegalArgumentException
-
H5Dget_type
public static int H5Dget_type(int dataset_id) throws HDF5LibraryException
H5Dget_type returns an identifier for a copy of the datatype for a dataset.- Parameters:
dataset_id
- Identifier of the dataset to query.- Returns:
- a datatype identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Diterate
public static int H5Diterate(byte[] buf, int buf_type, int space_id, H5D_iterate_cb op, H5D_iterate_t op_data) throws HDF5LibraryException, java.lang.NullPointerException
H5Diterate iterates over all the data elements in the memory buffer buf, executing the callback function operator once for each such data element.- Parameters:
buf
- IN/OUT: Pointer to the memory containing the elements to iterate over.buf_type
- IN: Buffer datatype identifier.space_id
- IN: Dataspace describing memory buffer.op
- IN: Callback function to operate on each value.op_data
- IN/OUT: Pointer to any user-efined data for use by operator function.- Returns:
- returns the return value of the first operator that returns a positive value, or zero if all members were processed with no operator returning non-zero.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - buf is null.
-
H5Dopen
@Deprecated public static int H5Dopen(int loc_id, java.lang.String name) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Dopen(int, String, int)
H5Dopen opens the existing dataset specified by a location identifier and name, loc_id and name, respectively.- Parameters:
loc_id
- IN: Location identifiername
- IN: Dataset name- Returns:
- a dataset identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Dopen
public static int H5Dopen(int loc_id, java.lang.String name, int dapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Dopen opens the existing dataset specified by a location identifier and name, loc_id and name, respectively.- Parameters:
loc_id
- IN: Location identifiername
- IN: Dataset namedapl_id
- IN: Identifier of dataset access property list.- Returns:
- a dataset identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Dread
public static int H5Dread(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, byte[] obj, boolean isCriticalPinning) throws HDF5LibraryException, java.lang.NullPointerException
H5Dread reads a (partial) dataset, specified by its identifier dataset_id, from the file into the application memory buffer buf.- Parameters:
dataset_id
- Identifier of the dataset read from.mem_type_id
- Identifier of the memory datatype.mem_space_id
- Identifier of the memory dataspace.file_space_id
- Identifier of the dataset's dataspace in the file.xfer_plist_id
- Identifier of a transfer property list for this I/O operation.obj
- Buffer to store data read from the file.isCriticalPinning
- request lock on data reference.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - data buffer is null.
-
H5Dread
public static int H5Dread(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, byte[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dread
public static int H5Dread(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.Object obj) throws HDF5Exception, HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5Exception
HDF5LibraryException
java.lang.NullPointerException
-
H5Dread
public static int H5Dread(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.Object obj, boolean isCriticalPinning) throws HDF5Exception, HDF5LibraryException, java.lang.NullPointerException
H5Dread reads a (partial) dataset, specified by its identifier dataset_id, from the file into the application data object.- Parameters:
dataset_id
- Identifier of the dataset read from.mem_type_id
- Identifier of the memory datatype.mem_space_id
- Identifier of the memory dataspace.file_space_id
- Identifier of the dataset's dataspace in the file.xfer_plist_id
- Identifier of a transfer property list for this I/O operation.obj
- Object to store data read from the file.isCriticalPinning
- request lock on data reference.- Returns:
- a non-negative value if successful
- Throws:
HDF5Exception
- - Failure in the data conversion.HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - data object is null.
-
H5Dread_double
public static int H5Dread_double(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, double[] buf, boolean isCriticalPinning) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dread_double
public static int H5Dread_double(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, double[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dread_float
public static int H5Dread_float(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, float[] buf, boolean isCriticalPinning) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dread_float
public static int H5Dread_float(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, float[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dread_int
public static int H5Dread_int(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, int[] buf, boolean isCriticalPinning) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dread_int
public static int H5Dread_int(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, int[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dread_long
public static int H5Dread_long(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, long[] buf, boolean isCriticalPinning) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dread_long
public static int H5Dread_long(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, long[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dread_reg_ref
public static int H5Dread_reg_ref(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.String[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dread_reg_ref_data
public static int H5Dread_reg_ref_data(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.String[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dread_short
public static int H5Dread_short(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, short[] buf, boolean isCriticalPinning) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dread_short
public static int H5Dread_short(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, short[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dread_string
public static int H5Dread_string(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.String[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5DreadVL
public static int H5DreadVL(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.Object[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dset_extent
public static void H5Dset_extent(int dset_id, long[] size) throws HDF5LibraryException, java.lang.NullPointerException
H5Dset_extent sets the current dimensions of the chunked dataset dset_id to the sizes specified in size.- Parameters:
dset_id
- IN: Chunked dataset identifier.size
- IN: Array containing the new magnitude of each dimension of the dataset.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - size is null.
-
H5Dvlen_get_buf_size
public static int H5Dvlen_get_buf_size(int dataset_id, int type_id, int space_id, int[] size) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Dvlen_get_buf_size_long
public static long H5Dvlen_get_buf_size_long(int dset_id, int type_id, int space_id) throws HDF5LibraryException
H5Dvlen_get_buf_size determines the number of bytes required to store the VL data from the dataset, using the space_id for the selection in the dataset on disk and the type_id for the memory representation of the VL data in memory.- Parameters:
dset_id
- IN: Identifier of the dataset read from.type_id
- IN: Identifier of the datatype.space_id
- IN: Identifier of the dataspace.- Returns:
- the size in bytes of the memory buffer required to store the VL data.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - buf is null.
-
H5Dvlen_reclaim
public static int H5Dvlen_reclaim(int type_id, int space_id, int xfer_plist_id, byte[] buf) throws HDF5LibraryException, java.lang.NullPointerException
H5Dvlen_reclaim reclaims buffer used for VL data.- Parameters:
type_id
- Identifier of the datatype.space_id
- Identifier of the dataspace.xfer_plist_id
- Identifier of a transfer property list for this I/O operation.buf
- Buffer with data to be reclaimed.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - buf is null.
-
H5Dwrite
public static int H5Dwrite(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, byte[] buf, boolean isCriticalPinning) throws HDF5LibraryException, java.lang.NullPointerException
H5Dwrite writes a (partial) dataset, specified by its identifier dataset_id, from the application memory buffer buf into the file.- Parameters:
dataset_id
- Identifier of the dataset read from.mem_type_id
- Identifier of the memory datatype.mem_space_id
- Identifier of the memory dataspace.file_space_id
- Identifier of the dataset's dataspace in the file.xfer_plist_id
- Identifier of a transfer property list for this I/O operation.buf
- Buffer with data to be written to the file.isCriticalPinning
- request lock on data reference.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Dwrite
public static int H5Dwrite(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, byte[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dwrite
public static int H5Dwrite(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.Object obj) throws HDF5Exception, HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5Exception
HDF5LibraryException
java.lang.NullPointerException
-
H5Dwrite
public static int H5Dwrite(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.Object obj, boolean isCriticalPinning) throws HDF5Exception, HDF5LibraryException, java.lang.NullPointerException
H5Dwrite writes a (partial) dataset, specified by its identifier dataset_id, from the application memory data object into the file.- Parameters:
dataset_id
- Identifier of the dataset read from.mem_type_id
- Identifier of the memory datatype.mem_space_id
- Identifier of the memory dataspace.file_space_id
- Identifier of the dataset's dataspace in the file.xfer_plist_id
- Identifier of a transfer property list for this I/O operation.obj
- Object with data to be written to the file.isCriticalPinning
- request lock on data reference.- Returns:
- a non-negative value if successful
- Throws:
HDF5Exception
- - Failure in the data conversion.HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - data object is null.
-
H5Dwrite_double
public static int H5Dwrite_double(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, double[] buf, boolean isCriticalPinning) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dwrite_double
public static int H5Dwrite_double(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, double[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dwrite_float
public static int H5Dwrite_float(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, float[] buf, boolean isCriticalPinning) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dwrite_float
public static int H5Dwrite_float(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, float[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dwrite_int
public static int H5Dwrite_int(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, int[] buf, boolean isCriticalPinning) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dwrite_int
public static int H5Dwrite_int(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, int[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dwrite_long
public static int H5Dwrite_long(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, long[] buf, boolean isCriticalPinning) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dwrite_long
public static int H5Dwrite_long(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, long[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dwrite_short
public static int H5Dwrite_short(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, short[] buf, boolean isCriticalPinning) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Dwrite_short
public static int H5Dwrite_short(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, short[] buf) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5DwriteString
public static int H5DwriteString(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.String[] buf) throws HDF5LibraryException, java.lang.NullPointerException
H5DwriteString writes a (partial) variable length String dataset, specified by its identifier dataset_id, from the application memory buffer buf into the file. ---- contributed by Rosetta Biosoftware- Parameters:
dataset_id
- Identifier of the dataset read from.mem_type_id
- Identifier of the memory datatype.mem_space_id
- Identifier of the memory dataspace.file_space_id
- Identifier of the dataset's dataspace in the file.xfer_plist_id
- Identifier of a transfer property list for this I/O operation.buf
- Buffer with data to be written to the file.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Eauto_is_v2
public static boolean H5Eauto_is_v2(int stack_id) throws HDF5LibraryException
H5Eauto_is_v2 determines whether the error auto reporting function for an error stack conforms to the H5E_auto2_t typedef or the H5E_auto1_t typedef.- Parameters:
stack_id
- IN: Error stack identifier.- Returns:
- boolean true if the error stack conforms to H5E_auto2_t and false if it conforms to H5E_auto1_t.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Eclear
public static int H5Eclear() throws HDF5LibraryException
H5Eclear clears the error stack for the current thread. H5Eclear can fail if there are problems initializing the library.This may be used by exception handlers to assure that the error condition in the HDF-5 library has been reset.
- Returns:
- Returns a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Eclear
public static void H5Eclear(int stack_id) throws HDF5LibraryException
H5Eclear clears the error stack specified by estack_id, or, if estack_id is set to H5E_DEFAULT, the error stack for the current thread.- Parameters:
stack_id
- IN: Error stack identifier.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Eclear2
public static void H5Eclear2(int stack_id) throws HDF5LibraryException
H5Eclear2 clears the error stack specified by estack_id, or, if estack_id is set to H5E_DEFAULT, the error stack for the current thread.- Parameters:
stack_id
- IN: Error stack identifier.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Eclose_msg
public static void H5Eclose_msg(int err_id) throws HDF5LibraryException
H5Eclose_msg closes an error message identifier, which can be either a major or minor message.- Parameters:
err_id
- IN: Error message identifier.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Eclose_stack
public static void H5Eclose_stack(int stack_id) throws HDF5LibraryException
H5Eclose_stack closes the object handle for an error stack and releases its resources.- Parameters:
stack_id
- IN: Error stack identifier.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Ecreate_msg
public static int H5Ecreate_msg(int cls_id, int msg_type, java.lang.String msg) throws HDF5LibraryException, java.lang.NullPointerException
H5Ecreate_msg adds an error message to an error class defined by client library or application program.- Parameters:
cls_id
- IN: Error class identifier.msg_type
- IN: The type of the error message.msg
- IN: The error message.- Returns:
- a message identifier
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - msg is null.
-
H5Ecreate_stack
public static int H5Ecreate_stack() throws HDF5LibraryException
H5Ecreate_stack creates a new empty error stack and returns the new stack's identifier.- Returns:
- an error stack identifier
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Eget_class_name
public static java.lang.String H5Eget_class_name(int class_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Eget_class_name retrieves the name of the error class specified by the class identifier.- Parameters:
class_id
- IN: Error class identifier.- Returns:
- the name of the error class
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
-
H5Eget_current_stack
public static int H5Eget_current_stack() throws HDF5LibraryException
H5Eget_current_stack copies the current error stack and returns an error stack identifier for the new copy.- Returns:
- an error stack identifier
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Eset_current_stack
public static void H5Eset_current_stack(int stack_id) throws HDF5LibraryException
H5Eset_current_stack replaces the content of the current error stack with a copy of the content of the error stack specified by estack_id.- Parameters:
stack_id
- IN: Error stack identifier.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Eget_msg
public static java.lang.String H5Eget_msg(int msg_id, int[] type_list) throws HDF5LibraryException
H5Eget_msg retrieves the error message including its length and type.- Parameters:
msg_id
- IN: Name of the error class.type_list
- OUT: The type of the error message. Valid values are H5E_MAJOR and H5E_MINOR.- Returns:
- the error message
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Eget_num
public static long H5Eget_num(int stack_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Eget_num retrieves the number of error records in the error stack specified by estack_id (including major, minor messages and description).- Parameters:
stack_id
- IN: Error stack identifier.- Returns:
- the number of error messages
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
-
H5Eprint1
@Deprecated public static void H5Eprint1(java.lang.Object stream) throws HDF5LibraryException
Deprecated.As of HDF5 1.8, replaced byH5Eprint2(int, Object)
H5Eprint1 prints the error stack specified by estack_id on the specified stream, stream.- Parameters:
stream
- IN: File pointer, or stderr if null.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Eprint2
public static void H5Eprint2(int stack_id, java.lang.Object stream) throws HDF5LibraryException
H5Eprint2 prints the error stack specified by estack_id on the specified stream, stream.- Parameters:
stack_id
- IN: Error stack identifier.If the identifier is H5E_DEFAULT, the current error stack will be printed.stream
- IN: File pointer, or stderr if null.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Epop
public static void H5Epop(int stack_id, long count) throws HDF5LibraryException
H5Epop deletes the number of error records specified in count from the top of the error stack specified by estack_id (including major, minor messages and description).- Parameters:
stack_id
- IN: Error stack identifier.count
- IN: Version of the client library or application to which the error class belongs.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Epush
public static void H5Epush(int stack_id, java.lang.String file, java.lang.String func, int line, int cls_id, int maj_id, int min_id, java.lang.String msg) throws HDF5LibraryException, java.lang.NullPointerException
H5Epush2 pushes a new error record onto the error stack specified by estack_id.- Parameters:
stack_id
- IN: Error stack identifier.file
- IN: Name of the file in which the error was detected.func
- IN: Name of the function in which the error was detected.line
- IN: Line number within the file at which the error was detected.cls_id
- IN: Error class identifier.maj_id
- IN: Major error identifier.min_id
- IN: Minor error identifier.msg
- IN: Error description string.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - file, func, or msg is null.
-
H5Epush2
public static void H5Epush2(int stack_id, java.lang.String file, java.lang.String func, int line, int cls_id, int maj_id, int min_id, java.lang.String msg) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Eregister_class
public static int H5Eregister_class(java.lang.String cls_name, java.lang.String lib_name, java.lang.String version) throws HDF5LibraryException, java.lang.NullPointerException
H5Eregister_class registers a client library or application program to the HDF5 error API so that the client library or application program can report errors together with HDF5 library.- Parameters:
cls_name
- IN: Name of the error class.lib_name
- IN: Name of the client library or application to which the error class belongs.version
- IN: Version of the client library or application to which the error class belongs.- Returns:
- a class identifier
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Eunregister_class
public static void H5Eunregister_class(int class_id) throws HDF5LibraryException
H5Eunregister_class removes the error class specified by class_id.- Parameters:
class_id
- IN: Error class identifier.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Ewalk
public static void H5Ewalk(int stack_id, int direction, H5E_walk_cb func, H5E_walk_t client_data) throws HDF5LibraryException, java.lang.NullPointerException
H5Ewalk walks the error stack specified by estack_id for the current thread and calls the function specified in func for each error along the way.- Parameters:
stack_id
- IN: Error stack identifier.direction
- IN: Direction in which the error stack is to be walked.func
- IN: Function to be called for each error encountered.client_data
- IN: Data to be passed with func.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - func is null.
-
H5Ewalk2
public static void H5Ewalk2(int stack_id, int direction, H5E_walk_cb func, H5E_walk_t client_data) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Fclose
public static int H5Fclose(int file_id) throws HDF5LibraryException
H5Fclose terminates access to an HDF5 file.- Parameters:
file_id
- Identifier of a file to terminate access to.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Fopen
public static int H5Fopen(java.lang.String name, int flags, int access_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Fopen opens an existing file and is the primary function for accessing existing HDF5 files.- Parameters:
name
- Name of the file to access.flags
- File access flags.access_id
- Identifier for the file access properties list.- Returns:
- a file identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Freopen
public static int H5Freopen(int file_id) throws HDF5LibraryException
H5Freopen reopens an HDF5 file.- Parameters:
file_id
- Identifier of a file to terminate and reopen access to.- Returns:
- a new file identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Fcreate
public static int H5Fcreate(java.lang.String name, int flags, int create_id, int access_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Fcreate is the primary function for creating HDF5 files.- Parameters:
name
- Name of the file to access.flags
- File access flags. Possible values include:- H5F_ACC_RDWR Allow read and write access to file.
- H5F_ACC_RDONLY Allow read-only access to file.
- H5F_ACC_TRUNC Truncate file, if it already exists, erasing all data previously stored in the file.
- H5F_ACC_EXCL Fail if file already exists.
- H5F_ACC_DEBUG Print debug information.
- H5P_DEFAULT Apply default file access and creation properties.
create_id
- File creation property list identifier, used when modifying default file meta-data. Use H5P_DEFAULT for default access properties.access_id
- File access property list identifier. If parallel file access is desired, this is a collective call according to the communicator stored in the access_id (not supported in Java). Use H5P_DEFAULT for default access properties.- Returns:
- a file identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Fflush
public static int H5Fflush(int object_id, int scope) throws HDF5LibraryException
H5Fflush causes all buffers associated with a file or object to be immediately flushed (written) to disk without removing the data from the (memory) cache.After this call completes, the file (or object) is in a consistent state and all data written to date is assured to be permanent.
- Parameters:
object_id
- Identifier of object used to identify the file. object_id can be any object associated with the file, including the file itself, a dataset, a group, an attribute, or a named data type.scope
- specifies the scope of the flushing action, in the case that the HDF-5 file is not a single physical file.Valid values are:
- H5F_SCOPE_GLOBAL Flushes the entire virtual file.
- H5F_SCOPE_LOCAL Flushes only the specified file.
- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Fget_access_plist
public static int H5Fget_access_plist(int file_id) throws HDF5LibraryException
H5Fget_access_plist returns the file access property list identifier of the specified file.- Parameters:
file_id
- Identifier of file to get access property list of- Returns:
- a file access property list identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Fget_create_plist
public static int H5Fget_create_plist(int file_id) throws HDF5LibraryException
H5Fget_create_plist returns a file creation property list identifier identifying the creation properties used to create this file.- Parameters:
file_id
- Identifier of the file to get creation property list- Returns:
- a file creation property list identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Fget_filesize
public static long H5Fget_filesize(int file_id) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Fget_freespace
public static long H5Fget_freespace(int file_id) throws HDF5LibraryException
H5Fget_freespace returns the amount of space that is unused by any objects in the file.- Parameters:
file_id
- IN: File identifier for a currently-open HDF5 file- Returns:
- the amount of free space in the file
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Fget_intent
public static int H5Fget_intent(int file_id) throws HDF5LibraryException
H5Fget_intent retrieves the intended access mode flag passed with H5Fopen when the file was opened.- Parameters:
file_id
- IN: File identifier for a currently-open HDF5 file- Returns:
- the intended access mode flag, as originally passed with H5Fopen.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Fget_mdc_hit_rate
public static double H5Fget_mdc_hit_rate(int file_id) throws HDF5LibraryException
H5Fget_mdc_hit_rate queries the metadata cache of the target file to obtain its hit rate (cache hits / (cache hits + cache misses)) since the last time hit rate statistics were reset.- Parameters:
file_id
- IN: Identifier of the target file.- Returns:
- the double in which the hit rate is returned.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Fget_mdc_size
public static int H5Fget_mdc_size(int file_id, long[] metadata_cache) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
H5Fget_mdc_size queries the metadata cache of the target file for the desired size information.- Parameters:
file_id
- IN: Identifier of the target file.metadata_cache
- OUT: Current metadata cache information- metadata_cache[0] = max_size_ptr // current cache maximum size
- metadata_cache[1] = min_clean_size_ptr // current cache minimum clean size
- metadata_cache[2] = cur_size_ptr // current cache size
- Returns:
- current number of entries in the cache
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - metadata_cache is null.java.lang.IllegalArgumentException
-
H5Fget_name
public static java.lang.String H5Fget_name(int obj_id) throws HDF5LibraryException
H5Fget_name retrieves the name of the file to which the object obj_id belongs.- Parameters:
obj_id
- IN: Identifier of the object for which the associated filename is sought.- Returns:
- the filename.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Fget_name
public static java.lang.String H5Fget_name(int obj_id, int size) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Fget_obj_count
public static int H5Fget_obj_count(int file_id, int types) throws HDF5LibraryException
H5Fget_obj_count returns the number of open object identifiers for the file.- Parameters:
file_id
- IN: File identifier for a currently-open HDF5 filetypes
- IN: Type of object for which identifiers are to be returned.- H5F_OBJ_FILE Files only
- H5F_OBJ_DATASET Datasets only
- H5F_OBJ_GROUP Groups only
- H5F_OBJ_DATATYPE Named datatypes only
- H5F_OBJ_ATTR Attributes only
- H5F_OBJ_ALL All of the above
- H5F_OBJ_LOCAL Restrict search to objects opened through current file identifier.
- Returns:
- the number of open objects.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Fget_obj_count_long
public static long H5Fget_obj_count_long(int file_id, int types) throws HDF5LibraryException
H5Fget_obj_count returns the number of open object identifiers for the file.- Parameters:
file_id
- IN: File identifier for a currently-open HDF5 filetypes
- IN: Type of object for which identifiers are to be returned.- H5F_OBJ_FILE Files only
- H5F_OBJ_DATASET Datasets only
- H5F_OBJ_GROUP Groups only
- H5F_OBJ_DATATYPE Named datatypes only
- H5F_OBJ_ATTR Attributes only
- H5F_OBJ_ALL All of the above
- H5F_OBJ_LOCAL Restrict search to objects opened through current file identifier.
- Returns:
- the number of open objects.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Fget_obj_ids
public static int H5Fget_obj_ids(int file_id, int types, int max_objs, int[] obj_id_list) throws HDF5LibraryException, java.lang.NullPointerException
H5Fget_obj_ids returns the list of identifiers for all open HDF5 objects fitting the specified criteria.- Parameters:
file_id
- IN: File identifier for a currently-open HDF5 filetypes
- IN: Type of object for which identifiers are to be returned.max_objs
- IN: Maximum number of object identifiers to place into obj_id_list.obj_id_list
- OUT: Pointer to the returned list of open object identifiers.- Returns:
- the number of objects placed into obj_id_list.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - obj_id_list is null.
-
H5Fget_obj_ids_long
public static long H5Fget_obj_ids_long(int file_id, int types, long max_objs, int[] obj_id_list) throws HDF5LibraryException, java.lang.NullPointerException
H5Fget_obj_ids returns the list of identifiers for all open HDF5 objects fitting the specified criteria.- Parameters:
file_id
- IN: File identifier for a currently-open HDF5 filetypes
- IN: Type of object for which identifiers are to be returned.max_objs
- IN: Maximum number of object identifiers to place into obj_id_list.obj_id_list
- OUT: Pointer to the returned list of open object identifiers.- Returns:
- the number of objects placed into obj_id_list.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - obj_id_list is null.
-
H5Fis_hdf5
public static boolean H5Fis_hdf5(java.lang.String name) throws HDF5LibraryException, java.lang.NullPointerException
H5Fis_hdf5 determines whether a file is in the HDF5 format.- Parameters:
name
- File name to check format.- Returns:
- true if is HDF-5, false if not.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Fmount
public static int H5Fmount(int loc_id, java.lang.String name, int child_id, int plist_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Fmount mounts the file specified by child_id onto the group specified by loc_id and name using the mount properties plist_id.- Parameters:
loc_id
- The identifier for the group onto which the file specified by child_id is to be mounted.name
- The name of the group onto which the file specified by child_id is to be mounted.child_id
- The identifier of the file to be mounted.plist_id
- The identifier of the property list to be used.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Funmount
public static int H5Funmount(int loc_id, java.lang.String name) throws HDF5LibraryException, java.lang.NullPointerException
Given a mount point, H5Funmount dissassociates the mount point's file from the file mounted there.- Parameters:
loc_id
- The identifier for the location at which the specified file is to be unmounted.name
- The name of the file to be unmounted.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Freset_mdc_hit_rate_stats
public static void H5Freset_mdc_hit_rate_stats(int file_id) throws HDF5LibraryException
H5Freset_mdc_hit_rate_stats resets the hit rate statistics counters in the metadata cache associated with the specified file.- Parameters:
file_id
- IN: Identifier of the target file.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Fget_info
public static H5F_info_t H5Fget_info(int obj_id) throws HDF5LibraryException
H5Fget_info returns global information for the file associated with the object identifier obj_id.- Parameters:
obj_id
- IN: Object identifier for any object in the file.- Returns:
- A buffer(H5F_info_t) for current "global" information about file
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Fclear_elink_file_cache
public static void H5Fclear_elink_file_cache(int file_id) throws HDF5LibraryException
H5Fclear_elink_file_cache evicts all the cached child files in the specified file's external file cache, causing them to be closed if there is nothing else holding them open.- Parameters:
file_id
- IN: Identifier of the target file.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Gclose
public static int H5Gclose(int group_id) throws HDF5LibraryException
H5Gclose releases resources used by a group which was opened by a call to H5Gcreate() or H5Gopen().- Parameters:
group_id
- Group identifier to release.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Gcreate
@Deprecated public static int H5Gcreate(int loc_id, java.lang.String name, long size_hint) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Gcreate(int, String, int, int, int)
H5Gcreate creates a new group with the specified name at the specified location, loc_id.- Parameters:
loc_id
- The file or group identifier.name
- The absolute or relative name of the new group.size_hint
- An optional parameter indicating the number of bytes to reserve for the names that will appear in the group.- Returns:
- a valid group identifier for the open group if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Gcreate
public static int H5Gcreate(int loc_id, java.lang.String name, int lcpl_id, int gcpl_id, int gapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Gcreate creates a new group with the specified name at the specified location, loc_id.- Parameters:
loc_id
- IN: The file or group identifier.name
- IN: The absolute or relative name of the new group.lcpl_id
- IN: Identifier of link creation property list.gcpl_id
- IN: Identifier of group creation property list.gapl_id
- IN: Identifier of group access property list. (No group access properties have been implemented at this time; use H5P_DEFAULT.)- Returns:
- a valid group identifier
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Gcreate_anon
public static int H5Gcreate_anon(int loc_id, int gcpl_id, int gapl_id) throws HDF5LibraryException
H5Gcreate_anon creates a new empty group in the file specified by loc_id.- Parameters:
loc_id
- IN: File or group identifier specifying the file in which the new group is to be created.gcpl_id
- IN: Identifier of group creation property list.gapl_id
- IN: Identifier of group access property list. (No group access properties have been implemented at this time; use H5P_DEFAULT.)- Returns:
- a valid group identifier
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Gget_comment
@Deprecated public static int H5Gget_comment(int loc_id, java.lang.String name, int bufsize, java.lang.String[] comment) throws java.lang.ArrayIndexOutOfBoundsException, java.lang.ArrayStoreException, HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
Deprecated.As of HDF5 1.8, replaced byH5Oget_comment(int)
H5Gget_comment retrieves the comment for the the object name. The comment is returned in the buffer comment.- Parameters:
loc_id
- IN: Identifier of the file, group, dataset, or datatype.name
- IN: Name of the object whose comment is to be set or reset.bufsize
- IN: Anticipated size of the buffer required to hold comment.comment
- OUT: The comment.- Returns:
- the number of characters in the comment, counting the null terminator, if successful
- Throws:
java.lang.ArrayIndexOutOfBoundsException
- - JNI error writing back datajava.lang.ArrayStoreException
- - JNI error writing back dataHDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.java.lang.IllegalArgumentException
- - size < 1, comment is invalid.
-
H5Gset_comment
@Deprecated public static int H5Gset_comment(int loc_id, java.lang.String name, java.lang.String comment) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Oset_comment(int, String)
H5Gset_comment sets the comment for the the object name to comment. Any previously existing comment is overwritten.- Parameters:
loc_id
- IN: Identifier of the file, group, dataset, or datatype.name
- IN: Name of the object whose comment is to be set or reset.comment
- IN: The new comment.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name or comment is null.
-
H5Gget_create_plist
public static int H5Gget_create_plist(int group_id) throws HDF5LibraryException
H5Gget_create_plist returns an identifier for the group creation property list associated with the group specified by group_id.- Parameters:
group_id
- IN: Identifier of the group.- Returns:
- an identifier for the group's creation property list
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Gget_info
public static H5G_info_t H5Gget_info(int group_id) throws HDF5LibraryException
H5Gget_info retrieves information about the group specified by group_id. The information is returned in the group_info struct.- Parameters:
group_id
- IN: Identifier of the group.- Returns:
- a structure in which group information is returned
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Gget_info_by_idx
public static H5G_info_t H5Gget_info_by_idx(int group_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Gget_info_by_idx retrieves information about a group, according to the group's position within an index.- Parameters:
group_id
- IN: File or group identifier.group_name
- IN: Name of group for which information is to be retrieved.idx_type
- IN: Type of index by which objects are orderedorder
- IN: Order of iteration within indexn
- IN: Attribute's position in indexlapl_id
- IN: Link access property list.- Returns:
- a structure in which group information is returned
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Gget_info_by_name
public static H5G_info_t H5Gget_info_by_name(int group_id, java.lang.String name, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Gget_info_by_name retrieves information about the group group_name located in the file or group specified by loc_id.- Parameters:
group_id
- IN: File or group identifier.name
- IN: Name of group for which information is to be retrieved.lapl_id
- IN: Link access property list.- Returns:
- a structure in which group information is returned
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Gget_linkval
@Deprecated public static int H5Gget_linkval(int loc_id, java.lang.String name, int size, java.lang.String[] value) throws java.lang.ArrayIndexOutOfBoundsException, java.lang.ArrayStoreException, HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
Deprecated.As of HDF5 1.8, replaced byH5Lget_val(int, String, String[] , int)
H5Gget_linkval returns size characters of the link value through the value argument if loc_id (a file or group identifier) and name specify a symbolic link.- Parameters:
loc_id
- IN: Identifier of the file, group, dataset, or datatype.name
- IN: Name of the object whose link value is to be checked.size
- IN: Maximum number of characters of value to be returned.value
- OUT: Link value.- Returns:
- a non-negative value, with the link value in value, if successful.
- Throws:
java.lang.ArrayIndexOutOfBoundsException
- Copy back failedjava.lang.ArrayStoreException
- Copy back failedHDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.java.lang.IllegalArgumentException
- - size is invalid
-
H5Gget_num_objs
@Deprecated public static int H5Gget_num_objs(int loc_id, long[] num_obj) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Gget_info(int)
Returns number of objects in the group specified by its identifier- Parameters:
loc_id
- Identifier of the group or the filenum_obj
- Number of objects in the group- Returns:
- positive value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - num_obj is null.
-
H5Gget_obj_info_all
public static int H5Gget_obj_info_all(int loc_id, java.lang.String name, java.lang.String[] objNames, int[] objTypes, long[] objRef) throws HDF5LibraryException, java.lang.NullPointerException
retrieves information of all objects under the group (name) located in the file or group specified by loc_id.- Parameters:
loc_id
- IN: File or group identifiername
- IN: Name of group for which information is to be retrievedobjNames
- OUT: Names of all objects under the group, name.objTypes
- OUT: Types of all objects under the group, name.objRef
- OUT: Reference number of all objects under the group, name.- Returns:
- the number of items found
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Gget_obj_info_all
public static int H5Gget_obj_info_all(int loc_id, java.lang.String name, java.lang.String[] oname, int[] otype, int[] ltype, long[] ref, int indx_type) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Gget_obj_info_all
public static int H5Gget_obj_info_all(int loc_id, java.lang.String name, java.lang.String[] oname, int[] otype, int[] ltype, long[] fno, long[] ref, int indx_type) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Gget_obj_info_full
public static int H5Gget_obj_info_full(int loc_id, java.lang.String name, java.lang.String[] oname, int[] otype, int[] ltype, long[] fno, long[] ref, int indx_type, int indx_order) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Gget_obj_info_idx
public static int H5Gget_obj_info_idx(int loc_id, java.lang.String name, int idx, java.lang.String[] oname, int[] type) throws HDF5LibraryException, java.lang.NullPointerException
H5Gget_obj_info_idx report the name and type of object with index 'idx' in a Group. The 'idx' corresponds to the index maintained by H5Giterate. Each link is returned, so objects with multiple links will be counted once for each link.- Parameters:
loc_id
- IN: file or group ID.name
- IN: name of the group to iterate, relative to the loc_ididx
- IN: the index of the object to iterate.oname
- the name of the object [OUT]type
- the type of the object [OUT]- Returns:
- non-negative if successful, -1 if not.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Gget_obj_info_max
public static int H5Gget_obj_info_max(int loc_id, java.lang.String[] objNames, int[] objTypes, int[] lnkTypes, long[] objRef, int objMax) throws HDF5LibraryException, java.lang.NullPointerException
retrieves information of all objects (recurvisely) under the group (name) located in the file or group specified by loc_id upto maximum specified by objMax.- Parameters:
loc_id
- IN: File or group identifierobjNames
- OUT: Names of all objects under the group, name.objTypes
- OUT: Types of all objects under the group, name.lnkTypes
- OUT: Types of all links under the group, name.objRef
- OUT: Reference number of all objects under the group, name.objMax
- IN: Maximum number of all objects under the group, name.- Returns:
- the number of items found
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Gget_objinfo
@Deprecated public static int H5Gget_objinfo(int loc_id, java.lang.String name, boolean follow_link, long[] fileno, long[] objno, int[] link_info, long[] mtime) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
Deprecated.As of HDF5 1.8, replaced byand #H5Oget_info(int)
H5Gget_objinfo returns information about the specified object.- Parameters:
loc_id
- IN: File, group, dataset, or datatype identifier.name
- IN: Name of the object for which status is being sought.follow_link
- IN: Link flag.fileno
- OUT: file id numbers.objno
- OUT: object id numbers.link_info
- OUT: link information.link_info[0] = nlink link_info[1] = type link_info[2] = linklen
mtime
- OUT: modification time- Returns:
- a non-negative value if successful, with the fields of link_info and mtime (if non-null) initialized.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name or array is null.java.lang.IllegalArgumentException
- - bad argument.
-
H5Gget_objinfo
@Deprecated public static int H5Gget_objinfo(int loc_id, java.lang.String name, boolean follow_link, HDF5GroupInfo info) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8H5Gget_objinfo returns information about the specified object in an HDF5GroupInfo object.- Parameters:
loc_id
- IN: File, group, dataset, or datatype identifier.name
- IN: Name of the object for which status is being sought.follow_link
- IN: Link flag.info
- OUT: the HDF5GroupInfo object to store the object infomation- Returns:
- a non-negative value if successful, with the fields of HDF5GroupInfo object (if non-null) initialized.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.- See Also:
See public synchronized static native int H5Gget_objinfo();
-
H5Gget_objname_by_idx
@Deprecated public static long H5Gget_objname_by_idx(int group_id, long idx, java.lang.String[] name, long size) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Lget_name_by_idx(int, String, int, int, long, int)
Returns a name of an object specified by an index.- Parameters:
group_id
- Group or file identifieridx
- Transient index identifying objectname
- the object namesize
- Name length- Returns:
- the size of the object name if successful, or 0 if no name is associated with the group identifier. Otherwise returns a negative value
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - current_name or name is null.
-
H5Gget_objtype_by_idx
@Deprecated public static int H5Gget_objtype_by_idx(int group_id, long idx) throws HDF5LibraryException
Deprecated.As of HDF5 1.8, replaced byH5Oget_info(int)
Returns the type of an object specified by an index.- Parameters:
group_id
- Group or file identifier.idx
- Transient index identifying object.- Returns:
- Returns the type of the object if successful. Otherwise returns a negative value
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Glink
@Deprecated public static int H5Glink(int loc_id, int link_type, java.lang.String current_name, java.lang.String new_name) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byand #H5Lcreate_soft(String, int, String, int, int)
H5Glink creates a new name for an already existing object.- Parameters:
loc_id
- File, group, dataset, or datatype identifier.link_type
- Link type. Possible values are:- H5G_LINK_HARD
- H5G_LINK_SOFT.
current_name
- A name of the existing object if link is a hard link. Can be anything for the soft link.new_name
- New name for the object.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - current_name or name is null.
-
H5Glink2
@Deprecated public static int H5Glink2(int curr_loc_id, java.lang.String current_name, int link_type, int new_loc_id, java.lang.String new_name) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8H5Glink creates a new name for an already existing object.- Parameters:
curr_loc_id
- File, group, dataset, or datatype identifier.link_type
- Link type. Possible values are:- H5G_LINK_HARD
- H5G_LINK_SOFT.
current_name
- A name of the existing object if link is a hard link. Can be anything for the soft link.new_loc_id
- File, group, dataset, or datatype identifier.new_name
- New name for the object.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - current_name or name is null.
-
H5Gunlink
@Deprecated public static int H5Gunlink(int loc_id, java.lang.String name) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Ldelete(int, String, int)
H5Gunlink removes an association between a name and an object.- Parameters:
loc_id
- Identifier of the file containing the object.name
- Name of the object to unlink.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Gmove
@Deprecated public static int H5Gmove(int loc_id, java.lang.String src, java.lang.String dst) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Lmove(int, String, int,String, int, int)
H5Gmove renames an object within an HDF5 file. The original name, src, is unlinked from the group graph and the new name, dst, is inserted as an atomic operation. Both names are interpreted relative to loc_id, which is either a file or a group identifier.- Parameters:
loc_id
- File or group identifier.src
- Object's original name.dst
- Object's new name.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - src or dst is null.
-
H5Gn_members_long
public static long H5Gn_members_long(int loc_id, java.lang.String name) throws HDF5LibraryException, java.lang.NullPointerException
H5Gn_members report the number of objects in a Group. The 'objects' include everything that will be visited by H5Giterate. Each link is returned, so objects with multiple links will be counted once for each link.- Parameters:
loc_id
- file or group ID.name
- name of the group to iterate, relative to the loc_id- Returns:
- the number of members in the group or -1 if error.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Gn_members
public static int H5Gn_members(int loc_id, java.lang.String name) throws HDF5LibraryException, java.lang.NullPointerException
H5Gn_members report the number of objects in a Group. The 'objects' include everything that will be visited by H5Giterate. Each link is returned, so objects with multiple links will be counted once for each link.- Parameters:
loc_id
- file or group ID.name
- name of the group to iterate, relative to the loc_id- Returns:
- the number of members in the group or -1 if error.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Gopen
@Deprecated public static int H5Gopen(int loc_id, java.lang.String name) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Gopen(int, String, int)
H5Gopen opens an existing group with the specified name at the specified location, loc_id.- Parameters:
loc_id
- File or group identifier within which group is to be open.name
- Name of group to open.- Returns:
- a valid group identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Gopen
public static int H5Gopen(int loc_id, java.lang.String name, int gapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Gopen opens an existing group, name, at the location specified by loc_id.- Parameters:
loc_id
- IN: File or group identifier specifying the location of the group to be opened.name
- IN: Name of group to open.gapl_id
- IN: Identifier of group access property list.- Returns:
- a valid group identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Iget_file_id
public static int H5Iget_file_id(int obj_id) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Iget_name_long
@Deprecated public static long H5Iget_name_long(int obj_id, java.lang.String[] name, long size) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Iget_name
public static java.lang.String H5Iget_name(int obj_id) throws HDF5LibraryException
H5Iget_name_str retrieves the name of an object specified by the identifier, obj_id.- Parameters:
obj_id
- IN: Identifier of the object.- Returns:
- String for Attribute name.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Iget_ref
public static int H5Iget_ref(int obj_id) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Idec_ref
public static int H5Idec_ref(int obj_id) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Iinc_ref
public static int H5Iinc_ref(int obj_id) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Iget_type
public static int H5Iget_type(int obj_id) throws HDF5LibraryException
H5Iget_type retrieves the type of the object identified by obj_id.- Parameters:
obj_id
- IN: Object identifier whose type is to be determined.- Returns:
- the object type if successful; otherwise H5I_BADID.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Iget_type_ref
public static int H5Iget_type_ref(int type_id) throws HDF5LibraryException
H5Iget_type_ref retrieves the reference count on an ID type. The reference count is used by the library to indicate when an ID type can be destroyed.- Parameters:
type_id
- IN: The identifier of the type whose reference count is to be retrieved- Returns:
- The current reference count on success, negative on failure.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Idec_type_ref
public static int H5Idec_type_ref(int type_id) throws HDF5LibraryException
H5Idec_type_ref decrements the reference count on an identifier type. The reference count is used by the library to indicate when an identifier type can be destroyed. If the reference count reaches zero, this function will destroy it.- Parameters:
type_id
- IN: The identifier of the type whose reference count is to be decremented- Returns:
- The current reference count on success, negative on failure.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Iinc_type_ref
public static int H5Iinc_type_ref(int type_id) throws HDF5LibraryException
H5Iinc_type_ref increments the reference count on an ID type. The reference count is used by the library to indicate when an ID type can be destroyed.- Parameters:
type_id
- IN: The identifier of the type whose reference count is to be incremented- Returns:
- The current reference count on success, negative on failure.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Inmembers
public static int H5Inmembers(int type_id) throws HDF5LibraryException
H5Inmembers returns the number of identifiers of the identifier type specified in type.- Parameters:
type_id
- IN: Identifier for the identifier type whose member count will be retrieved- Returns:
- Number of identifiers of the specified identifier type
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Iis_valid
public static boolean H5Iis_valid(int obj_id) throws HDF5LibraryException
H5Iis_valid indicates if the identifier type specified in obj_id is valid.- Parameters:
obj_id
- IN: Identifier to be checked- Returns:
- a boolean, true if the specified identifier id is valid
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Itype_exists
public static boolean H5Itype_exists(int type_id) throws HDF5LibraryException
H5Itype_exists indicates if the identifier type specified in type exists.- Parameters:
type_id
- IN: the identifier type to be checked- Returns:
- a boolean, true if the specified identifier type exists
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Iclear_type
public static void H5Iclear_type(int type_id, boolean force) throws HDF5LibraryException
H5Iclear_type deletes all identifiers of the type identified by the argument type.- Parameters:
type_id
- IN: Identifier of identifier type which is to be cleared of identifiersforce
- IN: Whether or not to force deletion of all identifiers- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Idestroy_type
public static void H5Idestroy_type(int type_id) throws HDF5LibraryException
H5Idestroy_type deletes an entire identifier type. All identifiers of this type are destroyed and no new identifiers of this type can be registered.- Parameters:
type_id
- IN: Identifier of identifier type which is to be destroyed- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Lcopy
public static void H5Lcopy(int src_loc, java.lang.String src_name, int dst_loc, java.lang.String dst_name, int lcpl_id, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Lcopy copies a link from one location to another.- Parameters:
src_loc
- IN: Location identifier of the source linksrc_name
- IN: Name of the link to be copieddst_loc
- IN: Location identifier specifying the destination of the copydst_name
- IN: Name to be assigned to the new copylcpl_id
- IN: Link creation property list identifierlapl_id
- IN: Link access property list identifier- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Lcreate_external
public static void H5Lcreate_external(java.lang.String file_name, java.lang.String obj_name, int link_loc_id, java.lang.String link_name, int lcpl_id, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Lcreate_external creates a new soft link to an external object, which is an object in a different HDF5 file from the location of the link.- Parameters:
file_name
- IN: Name of the target file containing the target object.obj_name
- IN: Path within the target file to the target object.link_loc_id
- IN: The file or group identifier for the new link.link_name
- IN: The name of the new link.lcpl_id
- IN: Link creation property list identifierlapl_id
- IN: Link access property list identifier- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Lcreate_hard
public static void H5Lcreate_hard(int cur_loc, java.lang.String cur_name, int dst_loc, java.lang.String dst_name, int lcpl_id, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Lcreate_hard creates a new hard link to a pre-existing object in an HDF5 file.- Parameters:
cur_loc
- IN: The file or group identifier for the target object.cur_name
- IN: Name of the target object, which must already exist.dst_loc
- IN: The file or group identifier for the new link.dst_name
- IN: The name of the new link.lcpl_id
- IN: Link creation property list identifierlapl_id
- IN: Link access property list identifier- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - cur_name or dst_name is null.
-
H5Lcreate_soft
public static void H5Lcreate_soft(java.lang.String link_target, int link_loc_id, java.lang.String link_name, int lcpl_id, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Lcreate_soft creates a new soft link to an object in an HDF5 file.- Parameters:
link_target
- IN: Path to the target object, which is not required to exist.link_loc_id
- IN: The file or group identifier for the new link.link_name
- IN: The name of the new link.lcpl_id
- IN: Link creation property list identifierlapl_id
- IN: Link access property list identifier- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - link_name is null.
-
H5Ldelete
public static void H5Ldelete(int loc_id, java.lang.String name, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Ldelete removes the link specified from a group.- Parameters:
loc_id
- IN: Identifier of the file or group containing the object.name
- IN: Name of the link to delete.lapl_id
- IN: Link access property list identifier- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Ldelete_by_idx
public static void H5Ldelete_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Ldelete_by_idx removes the nth link in a group according to the specified order and in the specified index.- Parameters:
loc_id
- IN: File or group identifier specifying location of subject groupgroup_name
- IN: Name of subject groupidx_type
- IN: Index or field which determines the orderorder
- IN: Order within field or indexn
- IN: Link for which to retrieve informationlapl_id
- IN: Link access property list identifier- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - group_name is null.
-
H5Lexists
public static boolean H5Lexists(int loc_id, java.lang.String name, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Lexists checks if a link with a particular name exists in a group.- Parameters:
loc_id
- IN: Identifier of the file or group to query.name
- IN: The name of the link to check.lapl_id
- IN: Link access property list identifier- Returns:
- a boolean, true if the name exists, otherwise false.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Lget_info
public static H5L_info_t H5Lget_info(int loc_id, java.lang.String name, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Lget_info returns information about the specified link.- Parameters:
loc_id
- IN: Identifier of the file or group.name
- IN: Name of the link for which information is being sought.lapl_id
- IN: Link access property list identifier- Returns:
- a buffer(H5L_info_t) for the link information.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Lget_info_by_idx
public static H5L_info_t H5Lget_info_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Lget_info_by_idx opens a named datatype at the location specified by loc_id and return an identifier for the datatype.- Parameters:
loc_id
- IN: File or group identifier specifying location of subject groupgroup_name
- IN: Name of subject groupidx_type
- IN: Type of indexorder
- IN: Order within field or indexn
- IN: Link for which to retrieve informationlapl_id
- IN: Link access property list identifier- Returns:
- a buffer(H5L_info_t) for the link information.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - group_name is null.
-
H5Lget_name_by_idx
public static java.lang.String H5Lget_name_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Lget_name_by_idx retrieves name of the nth link in a group, according to the order within a specified field or index.- Parameters:
loc_id
- IN: File or group identifier specifying location of subject groupgroup_name
- IN: Name of subject groupidx_type
- IN: Type of indexorder
- IN: Order within field or indexn
- IN: Link for which to retrieve informationlapl_id
- IN: Link access property list identifier- Returns:
- a String for the link name.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - group_name is null.
-
H5Lget_val
public static int H5Lget_val(int loc_id, java.lang.String name, java.lang.String[] link_value, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Lget_val returns the link value of a symbolic link. Note that this function is a combination of H5Lget_info(), H5Lget_val() and for external links, H5Lunpack_elink_val.- Parameters:
loc_id
- IN: Identifier of the file or group containing the object.name
- IN: Name of the symbolic link.link_value
- OUT: Path of the symbolic link, or the file_name and path of an external file.lapl_id
- IN: Link access property list identifier- Returns:
- the link type
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Lget_val_by_idx
public static int H5Lget_val_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, java.lang.String[] link_value, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Lget_val_by_idx retrieves value of the nth link in a group, according to the order within an index. Note that this function is a combination of H5Lget_info(), H5Lget_val() and for external links, H5Lunpack_elink_val.- Parameters:
loc_id
- IN: File or group identifier specifying location of subject groupgroup_name
- IN: Name of subject groupidx_type
- IN: Type of indexorder
- IN: Order within field or indexn
- IN: Link for which to retrieve informationlink_value
- OUT: Path of the symbolic link, or the file_name and path of an external file.lapl_id
- IN: Link access property list identifier- Returns:
- the link type
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - group_name is null.
-
H5Literate
public static int H5Literate(int grp_id, int idx_type, int order, long idx, H5L_iterate_cb op, H5L_iterate_t op_data) throws HDF5LibraryException
H5Literate iterates through links in a group.- Parameters:
grp_id
- IN: Identifier specifying subject groupidx_type
- IN: Type of indexorder
- IN: Order of iteration within indexidx
- IN: Iteration position at which to startop
- IN: Callback function passing data regarding the link to the calling applicationop_data
- IN: User-defined pointer to data required by the application for its processing of the link- Returns:
- returns the return value of the first operator that returns a positive value, or zero if all members were processed with no operator returning non-zero.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Literate_by_name
public static int H5Literate_by_name(int grp_id, java.lang.String group_name, int idx_type, int order, long idx, H5L_iterate_cb op, H5L_iterate_t op_data, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Literate_by_name iterates through links in a group.- Parameters:
grp_id
- IN: Identifier specifying subject groupgroup_name
- IN: Name of subject groupidx_type
- IN: Type of indexorder
- IN: Order of iteration within indexidx
- IN: Iteration position at which to startop
- IN: Callback function passing data regarding the link to the calling applicationop_data
- IN: User-defined pointer to data required by the application for its processing of the linklapl_id
- IN: Link access property list identifier- Returns:
- returns the return value of the first operator that returns a positive value, or zero if all members were processed with no operator returning non-zero.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - group_name is null.
-
H5Lmove
public static void H5Lmove(int src_loc, java.lang.String src_name, int dst_loc, java.lang.String dst_name, int lcpl_id, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Lmove renames a link within an HDF5 file.- Parameters:
src_loc
- IN: Original file or group identifier.src_name
- IN: Original link name.dst_loc
- IN: Destination file or group identifier.dst_name
- IN: New link name.lcpl_id
- IN: Link creation property list identifier to be associated with the new link.lapl_id
- IN: Link access property list identifier to be associated with the new link.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Lvisit
public static int H5Lvisit(int grp_id, int idx_type, int order, H5L_iterate_cb op, H5L_iterate_t op_data) throws HDF5LibraryException
H5Lvisit recursively visits all links starting from a specified group.- Parameters:
grp_id
- IN: Identifier specifying subject groupidx_type
- IN: Type of indexorder
- IN: Order of iteration within indexop
- IN: Callback function passing data regarding the link to the calling applicationop_data
- IN: User-defined pointer to data required by the application for its processing of the link- Returns:
- returns the return value of the first operator that returns a positive value, or zero if all members were processed with no operator returning non-zero.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Lvisit_by_name
public static int H5Lvisit_by_name(int loc_id, java.lang.String group_name, int idx_type, int order, H5L_iterate_cb op, H5L_iterate_t op_data, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Lvisit_by_name recursively visits all links starting from a specified group.- Parameters:
loc_id
- IN: Identifier specifying subject groupgroup_name
- IN: Name of subject groupidx_type
- IN: Type of indexorder
- IN: Order of iteration within indexop
- IN: Callback function passing data regarding the link to the calling applicationop_data
- IN: User-defined pointer to data required by the application for its processing of the linklapl_id
- IN: link access property- Returns:
- returns the return value of the first operator that returns a positive value, or zero if all members were processed with no operator returning non-zero.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - group_name is null.
-
H5Lis_registered
public static int H5Lis_registered(int link_cls_id) throws HDF5LibraryException
H5Lis_registered tests whether a user-defined link class is currently registered, either by the HDF5 Library or by the user through the use of H5Lregister.- Parameters:
link_cls_id
- IN: User-defined link class identifier- Returns:
- Returns a positive value if the link class has been registered and zero if it is unregistered. Otherwise returns a negative value; this may mean that the identifier is not a valid user-defined class identifier.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Lunregister
public static void H5Lunregister(int link_cls_id) throws HDF5LibraryException
H5Lunregister unregisters a class of user-defined links, preventing them from being traversed, queried, moved, etc.- Parameters:
link_cls_id
- IN: User-defined link class identifier- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Oclose
public static int H5Oclose(int object_id) throws HDF5LibraryException
H5Oclose closes the group, dataset, or named datatype specified.- Parameters:
object_id
- IN: Object identifier- Returns:
- non-negative on success
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Ocopy
public static void H5Ocopy(int src_loc_id, java.lang.String src_name, int dst_loc_id, java.lang.String dst_name, int ocpypl_id, int lcpl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Ocopy copies the group, dataset or named datatype specified from the file or group specified by source location to the destination location.- Parameters:
src_loc_id
- IN: Object identifier indicating the location of the source object to be copiedsrc_name
- IN: Name of the source object to be copieddst_loc_id
- IN: Location identifier specifying the destinationdst_name
- IN: Name to be assigned to the new copyocpypl_id
- IN: Object copy property listlcpl_id
- IN: Link creation property list for the new hard link- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Oget_comment
public static java.lang.String H5Oget_comment(int obj_id) throws HDF5LibraryException
H5Oget_comment retrieves the comment for the specified object.- Parameters:
obj_id
- IN: File or group identifier- Returns:
- the comment
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Oset_comment
@Deprecated public static void H5Oset_comment(int obj_id, java.lang.String comment) throws HDF5LibraryException
Deprecated.As of HDF5 1.8 in favor of object attributes.H5Oset_comment sets the comment for the specified object.- Parameters:
obj_id
- IN: Identifier of the target objectcomment
- IN: The new comment.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Oget_comment_by_name
public static java.lang.String H5Oget_comment_by_name(int loc_id, java.lang.String name, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Oget_comment_by_name retrieves the comment for an object.- Parameters:
loc_id
- IN: Identifier of a file, group, dataset, or named datatype.name
- IN: Relative name of the object whose comment is to be set or reset.lapl_id
- IN: Link access property list identifier.- Returns:
- the comment
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Oset_comment_by_name
@Deprecated public static void H5Oset_comment_by_name(int loc_id, java.lang.String name, java.lang.String comment, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8 in favor of object attributes.H5Oset_comment_by_name sets the comment for the specified object.- Parameters:
loc_id
- IN: Identifier of a file, group, dataset, or named datatype.name
- IN: Relative name of the object whose comment is to be set or reset.comment
- IN: The new comment.lapl_id
- IN: Link access property list identifier.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Oget_info
public static H5O_info_t H5Oget_info(int loc_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Oget_info retrieves the metadata for an object specified by an identifier.- Parameters:
loc_id
- IN: Identifier for target object- Returns:
- object information
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Oget_info_by_idx
public static H5O_info_t H5Oget_info_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Oget_info_by_idx retrieves the metadata for an object, identifying the object by an index position.- Parameters:
loc_id
- IN: File or group identifiergroup_name
- IN: Name of group, relative to loc_id, in which object is locatedidx_type
- IN: Type of index by which objects are orderedorder
- IN: Order of iteration within indexn
- IN: Object to openlapl_id
- IN: Access property list identifier for the link pointing to the object (Not currently used; pass as H5P_DEFAULT.)- Returns:
- object information
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Oget_info_by_name
public static H5O_info_t H5Oget_info_by_name(int loc_id, java.lang.String name, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Oget_info_by_name retrieves the metadata for an object, identifying the object by location and relative name.- Parameters:
loc_id
- IN: File or group identifier specifying location of group in which object is locatedname
- IN: Relative name of grouplapl_id
- IN: Access property list identifier for the link pointing to the object (Not currently used; pass as H5P_DEFAULT.)- Returns:
- object information
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Olink
public static void H5Olink(int obj_id, int new_loc_id, java.lang.String new_name, int lcpl_id, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Olink creates a new hard link to an object in an HDF5 file.- Parameters:
obj_id
- IN: Object to be linked.new_loc_id
- IN: File or group identifier specifying location at which object is to be linked.new_name
- IN: Relative name of link to be created.lcpl_id
- IN: Link creation property list identifier.lapl_id
- IN: Access property list identifier.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Oopen
public static int H5Oopen(int loc_id, java.lang.String name, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Oopen opens a group, dataset, or named datatype specified by a location and a path name.- Parameters:
loc_id
- IN: File or group identifiername
- IN: Relative path to the objectlapl_id
- IN: Access property list identifier for the link pointing to the object- Returns:
- an object identifier for the opened object
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Ovisit
public static int H5Ovisit(int obj_id, int idx_type, int order, H5O_iterate_cb op, H5O_iterate_t op_data) throws HDF5LibraryException, java.lang.NullPointerException
H5Ovisit recursively visits all objects accessible from a specified object.- Parameters:
obj_id
- IN: Identifier of the object at which the recursive iteration begins.idx_type
- IN: Type of indexorder
- IN: Order of iteration within indexop
- IN: Callback function passing data regarding the object to the calling applicationop_data
- IN: User-defined pointer to data required by the application for its processing of the object- Returns:
- returns the return value of the first operator that returns a positive value, or zero if all members were processed with no operator returning non-zero.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Ovisit_by_name
public static int H5Ovisit_by_name(int loc_id, java.lang.String obj_name, int idx_type, int order, H5O_iterate_cb op, H5O_iterate_t op_data, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Ovisit_by_name recursively visits all objects starting from a specified object.- Parameters:
loc_id
- IN: File or group identifierobj_name
- IN: Relative path to the objectidx_type
- IN: Type of indexorder
- IN: Order of iteration within indexop
- IN: Callback function passing data regarding the object to the calling applicationop_data
- IN: User-defined pointer to data required by the application for its processing of the objectlapl_id
- IN: Link access property list identifier- Returns:
- returns the return value of the first operator that returns a positive value, or zero if all members were processed with no operator returning non-zero.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Oexists_by_name
public static boolean H5Oexists_by_name(int loc_id, java.lang.String obj_name, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Oexists_by_name is used by an application to check that an existing link resolves to an object. Primarily, it is designed to check for dangling soft, external, or user-defined links.- Parameters:
loc_id
- IN: File or group identifierobj_name
- IN: Relative path to the objectlapl_id
- IN: Link access property list identifier- Returns:
- Returns TRUE or FALSE if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Odecr_refcount
public static void H5Odecr_refcount(int object_id) throws HDF5LibraryException
H5Odecr_refcount decrements the hard link reference count for an object.- Parameters:
object_id
- IN: Object identifier- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Oincr_refcount
public static void H5Oincr_refcount(int object_id) throws HDF5LibraryException
H5Oincr_refcount increments the hard link reference count for an object.- Parameters:
object_id
- IN: Object identifier- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Oopen_by_addr
public static int H5Oopen_by_addr(int loc_id, long addr) throws HDF5LibraryException
H5Oopen_by_addr opens a group, dataset, or named datatype using its address within an HDF5 file.- Parameters:
loc_id
- IN: File or group identifieraddr
- IN: Object's address in the file- Returns:
- an object identifier for the opened object
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Oopen_by_idx
public static int H5Oopen_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Oopen_by_idx opens the nth object in the group specified.- Parameters:
loc_id
- IN: File or group identifiergroup_name
- IN: Name of group, relative to loc_id, in which object is locatedidx_type
- IN: Type of index by which objects are orderedorder
- IN: Order of iteration within indexn
- IN: Object to openlapl_id
- IN: Access property list identifier for the link pointing to the object- Returns:
- an object identifier for the opened object
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - group_name is null.
-
_H5Oopen_by_idx
public static int _H5Oopen_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pget_class_name
public static java.lang.String H5Pget_class_name(int plid) throws HDF5LibraryException
H5Pget_class_name retrieves the name of a generic property list class- Parameters:
plid
- IN: Identifier of property object to query- Returns:
- name of a property list if successful; null if failed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pcreate
public static int H5Pcreate(int type) throws HDF5LibraryException
H5Pcreate creates a new property as an instance of some property list class.- Parameters:
type
- IN: The type of property list to create.- Returns:
- a property list identifier (plist) if successful; otherwise Fail (-1).
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget
public static int H5Pget(int plid, java.lang.String name) throws HDF5LibraryException
H5Pget retrieves a copy of the value for a property in a property list (support integer only)- Parameters:
plid
- IN: Identifier of property object to queryname
- IN: Name of property to query- Returns:
- value for a property if successful; a negative value if failed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset
public static int H5Pset(int plid, java.lang.String name, int value) throws HDF5LibraryException
Sets a property list value (support integer only)- Parameters:
plid
- IN: Property list identifier to modifyname
- IN: Name of property to modifyvalue
- IN: value to set the property to- Returns:
- a non-negative value if successful; a negative value if failed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pexist
public static int H5Pexist(int plid, java.lang.String name) throws HDF5LibraryException
H5Pexist determines whether a property exists within a property list or class- Parameters:
plid
- IN: Identifier for the property to queryname
- IN: Name of property to check for- Returns:
- a positive value if the property exists in the property object; zero if the property does not exist; a negative value if failed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_size
public static long H5Pget_size(int plid, java.lang.String name) throws HDF5LibraryException
H5Pget_size retrieves the size of a property's value in bytes- Parameters:
plid
- IN: Identifier of property object to queryname
- IN: Name of property to query- Returns:
- size of a property's value if successful; a negative value if failed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_nprops
public static long H5Pget_nprops(int plid) throws HDF5LibraryException
H5Pget_nprops retrieves the number of properties in a property list or class- Parameters:
plid
- IN: Identifier of property object to query- Returns:
- number of properties if successful; a negative value if failed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_class
public static int H5Pget_class(int plist) throws HDF5LibraryException
H5Pget_class returns the property list class for the property list identified by the plist parameter.- Parameters:
plist
- IN: Identifier of property list to query.- Returns:
- a property list class if successful. Otherwise returns H5P_NO_CLASS (-1).
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_class_parent
public static int H5Pget_class_parent(int plid) throws HDF5LibraryException
H5Pget_class_parent retrieves an identifier for the parent class of a property class- Parameters:
plid
- IN: Identifier of the property class to query- Returns:
- a valid parent class object identifier if successful; a negative value if failed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pequal
public static int H5Pequal(int plid1, int plid2) throws HDF5LibraryException
H5Pequal determines if two property lists or classes are equal- Parameters:
plid1
- IN: First property object to be comparedplid2
- IN: Second property object to be compared- Returns:
- positive value if equal; zero if unequal, a negative value if failed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5P_equal
public static boolean H5P_equal(int plid1, int plid2) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Pisa_class
public static int H5Pisa_class(int plist, int pclass) throws HDF5LibraryException
H5Pisa_class checks to determine whether a property list is a member of the specified class- Parameters:
plist
- IN: Identifier of the property listpclass
- IN: Identifier of the property class- Returns:
- a positive value if equal; zero if unequal; a negative value if failed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pcopy_prop
public static int H5Pcopy_prop(int dst_id, int src_id, java.lang.String name) throws HDF5LibraryException
H5Pcopy_prop copies a property from one property list or class to another- Parameters:
dst_id
- IN: Identifier of the destination property list or classsrc_id
- IN: Identifier of the source property list or classname
- IN: Name of the property to copy- Returns:
- a non-negative value if successful; a negative value if failed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Premove
public static int H5Premove(int plid, java.lang.String name) throws HDF5LibraryException
H5Premove removes a property from a property list- Parameters:
plid
- IN: Identifier of the property list to modifyname
- IN: Name of property to remove- Returns:
- a non-negative value if successful; a negative value if failed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Punregister
public static int H5Punregister(int plid, java.lang.String name) throws HDF5LibraryException
H5Punregister removes a property from a property list class- Parameters:
plid
- IN: Property list class from which to remove permanent propertyname
- IN: Name of property to remove- Returns:
- a non-negative value if successful; a negative value if failed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pclose_class
public static int H5Pclose_class(int plid) throws HDF5LibraryException
Closes an existing property list class- Parameters:
plid
- IN: Property list class to close- Returns:
- a non-negative value if successful; a negative value if failed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
_H5Pclose_class
public static int _H5Pclose_class(int plid) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Pclose
public static int H5Pclose(int plist) throws HDF5LibraryException
H5Pclose terminates access to a property list.- Parameters:
plist
- IN: Identifier of the property list to terminate access to.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pcopy
public static int H5Pcopy(int plist) throws HDF5LibraryException
H5Pcopy copies an existing property list to create a new property list.- Parameters:
plist
- IN: Identifier of property list to duplicate.- Returns:
- a property list identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pcreate_class_nocb
public static int H5Pcreate_class_nocb(int parent_class, java.lang.String name) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Pregister2_nocb
public static void H5Pregister2_nocb(int plist_class, java.lang.String name, long size, byte[] def_value) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Pinsert2_nocb
public static void H5Pinsert2_nocb(int plist, java.lang.String name, long size, byte[] value) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Piterate
public static int H5Piterate(int plist, int[] idx, H5P_iterate_cb op, H5P_iterate_t op_data) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Pget_attr_phase_change
public static int H5Pget_attr_phase_change(int ocpl_id, int[] attributes) throws HDF5LibraryException, java.lang.NullPointerException
H5Pget_attr_phase_change retrieves attribute storage phase change thresholds.- Parameters:
ocpl_id
- IN: : Object (dataset or group) creation property list identifierattributes
- The maximun and minimum no. of attributes to be stored.attributes[0] = The maximum number of attributes to be stored in compact storage attributes[1] = The minimum number of attributes to be stored in dense storage
- Returns:
- Returns a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - size is null.
-
H5Pset_attr_phase_change
public static void H5Pset_attr_phase_change(int ocpl_id, int max_compact, int min_dense) throws HDF5LibraryException
H5Pset_attr_phase_change sets threshold values for attribute storage on an object. These thresholds determine the point at which attribute storage changes from compact storage (i.e., storage in the object header) to dense storage (i.e., storage in a heap and indexed with a B-tree).- Parameters:
ocpl_id
- IN: : Object (dataset or group) creation property list identifiermax_compact
- IN: Maximum number of attributes to be stored in compact storage (Default: 8)min_dense
- IN: Minimum number of attributes to be stored in dense storage (Default: 6)- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_attr_creation_order
public static int H5Pget_attr_creation_order(int ocpl_id) throws HDF5LibraryException
H5Pget_attr_creation_order retrieves the settings for tracking and indexing attribute creation order on an object- Parameters:
ocpl_id
- IN: Object (group or dataset) creation property list identifier- Returns:
- Flags specifying whether to track and index attribute creation order
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_attr_creation_order
public static int H5Pset_attr_creation_order(int ocpl_id, int crt_order_flags) throws HDF5LibraryException
H5Pset_attr_creation_order sets flags specifying whether to track and index attribute creation order on an object.- Parameters:
ocpl_id
- IN: Object creation property list identifiercrt_order_flags
- IN: Flags specifying whether to track and index attribute creation order- Returns:
- Returns a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_obj_track_times
public static boolean H5Pget_obj_track_times(int ocpl_id) throws HDF5LibraryException
H5Pget_obj_track_times queries the object creation property list, ocpl_id, to determine whether object times are being recorded.- Parameters:
ocpl_id
- IN: Object creation property list identifier- Returns:
- TRUE or FALSE, specifying whether object times are being recorded
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_obj_track_times
public static void H5Pset_obj_track_times(int ocpl_id, boolean track_times) throws HDF5LibraryException
H5Pset_obj_track_times sets a property in the object creation property list, ocpl_id, that governs the recording of times associated with an object.- Parameters:
ocpl_id
- IN: Object creation property list identifiertrack_times
- IN: TRUE or FALSE, specifying whether object times are to be tracked- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pmodify_filter
public static int H5Pmodify_filter(int plist, int filter, int flags, long cd_nelmts, int[] cd_values) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pset_filter
public static int H5Pset_filter(int plist, int filter, int flags, long cd_nelmts, int[] cd_values) throws HDF5LibraryException
H5Pset_filter adds the specified filter and corresponding properties to the end of an output filter pipeline.- Parameters:
plist
- IN: Property list identifier.filter
- IN: Filter to be added to the pipeline.flags
- IN: Bit vector specifying certain general properties of the filter.cd_nelmts
- IN: Number of elements in cd_valuescd_values
- IN: Auxiliary data for the filter.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_nfilters
public static int H5Pget_nfilters(int plist) throws HDF5LibraryException
H5Pget_nfilters returns the number of filters defined in the filter pipeline associated with the property list plist.- Parameters:
plist
- IN: Property list identifier.- Returns:
- the number of filters in the pipeline if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_filter
@Deprecated public static int H5Pget_filter(int plist, int filter_number, int[] flags, int[] cd_nelmts, int[] cd_values, int namelen, java.lang.String[] name) throws java.lang.ArrayIndexOutOfBoundsException, java.lang.ArrayStoreException, HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Pget_filter(int, int, int[], long[], int[], long, String[], int[])
H5Pget_filter returns information about a filter, specified by its filter number, in a filter pipeline, specified by the property list with which it is associated.- Parameters:
plist
- IN: Property list identifier.filter_number
- IN: Sequence number within the filter pipeline of the filter for which information is sought.flags
- OUT: Bit vector specifying certain general properties of the filter.cd_nelmts
- IN/OUT: Number of elements in cd_valuescd_values
- OUT: Auxiliary data for the filter.namelen
- IN: Anticipated number of characters in name.name
- OUT: Name of the filter.- Returns:
- the filter identification number if successful. Otherwise returns H5Z_FILTER_ERROR (-1).
- Throws:
java.lang.ArrayIndexOutOfBoundsException
- Fatal error on Copybackjava.lang.ArrayStoreException
- Fatal error on CopybackHDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name or an array is null.
-
H5Pget_filter
public static int H5Pget_filter(int plist, int filter_number, int[] flags, long[] cd_nelmts, int[] cd_values, long namelen, java.lang.String[] name, int[] filter_config) throws java.lang.ArrayIndexOutOfBoundsException, java.lang.ArrayStoreException, HDF5LibraryException, java.lang.NullPointerException
H5Pget_filter returns information about a filter, specified by its filter number, in a filter pipeline, specified by the property list with which it is associated.- Parameters:
plist
- IN: Property list identifier.filter_number
- IN: Sequence number within the filter pipeline of the filter for which information is sought.flags
- OUT: Bit vector specifying certain general properties of the filter.cd_nelmts
- IN/OUT: Number of elements in cd_valuescd_values
- OUT: Auxiliary data for the filter.namelen
- IN: Anticipated number of characters in name.name
- OUT: Name of the filter.filter_config
- OUT:A bit field encoding the returned filter information- Returns:
- the filter identification number if successful. Otherwise returns H5Z_FILTER_ERROR (-1).
- Throws:
java.lang.ArrayIndexOutOfBoundsException
- Fatal error on Copybackjava.lang.ArrayStoreException
- Fatal error on CopybackHDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name or an array is null.
-
H5Pget_filter_by_id
@Deprecated public static int H5Pget_filter_by_id(int plist_id, int filter_id, int[] flags, long[] cd_nelmts, int[] cd_values, long namelen, java.lang.String[] name) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Pget_filter_by_id(int, int, int[], long[], int[], long, String[], int[])
H5Pget_filter_by_id returns information about the filter specified in filter_id, a filter identifier. plist_id must be a dataset or group creation property list and filter_id must be in the associated filter pipeline. The filter_id and flags parameters are used in the same manner as described in the discussion of H5Pset_filter. Aside from the fact that they are used for output, the parameters cd_nelmts and cd_values[] are used in the same manner as described in the discussion of H5Pset_filter. On input, the cd_nelmts parameter indicates the number of entries in the cd_values[] array allocated by the calling program; on exit it contains the number of values defined by the filter. On input, the namelen parameter indicates the number of characters allocated for the filter name by the calling program in the array name[]. On exit name[] contains the name of the filter with one character of the name in each element of the array. If the filter specified in filter_id is not set for the property list, an error will be returned and H5Pget_filter_by_id1 will fail.- Parameters:
plist_id
- IN: Property list identifier.filter_id
- IN: Filter identifier.flags
- OUT: Bit vector specifying certain general properties of the filter.cd_nelmts
- N/OUT: Number of elements in cd_valuescd_values
- OUT: Auxiliary data for the filter.namelen
- IN: Anticipated number of characters in name.name
- OUT: Name of the filter.- Returns:
- the filter identification number if successful. Otherwise returns H5Z_FILTER_ERROR (-1).
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.ArrayIndexOutOfBoundsException
- Fatal error on Copybackjava.lang.ArrayStoreException
- Fatal error on Copybackjava.lang.NullPointerException
- - name or an array is null.
-
H5Pget_filter_by_id
public static int H5Pget_filter_by_id(int plist_id, int filter_id, int[] flags, long[] cd_nelmts, int[] cd_values, long namelen, java.lang.String[] name, int[] filter_config) throws java.lang.ArrayIndexOutOfBoundsException, java.lang.ArrayStoreException, HDF5LibraryException, java.lang.NullPointerException
H5Pget_filter_by_id returns information about the filter specified in filter_id, a filter identifier. plist_id must be a dataset or group creation property list and filter_id must be in the associated filter pipeline. The filter_id and flags parameters are used in the same manner as described in the discussion of H5Pset_filter. Aside from the fact that they are used for output, the parameters cd_nelmts and cd_values[] are used in the same manner as described in the discussion of H5Pset_filter. On input, the cd_nelmts parameter indicates the number of entries in the cd_values[] array allocated by the calling program; on exit it contains the number of values defined by the filter. On input, the namelen parameter indicates the number of characters allocated for the filter name by the calling program in the array name[]. On exit name[] contains the name of the filter with one character of the name in each element of the array. If the filter specified in filter_id is not set for the property list, an error will be returned and H5Pget_filter_by_id1 will fail.- Parameters:
plist_id
- IN: Property list identifier.filter_id
- IN: Filter identifier.flags
- OUT: Bit vector specifying certain general properties of the filter.cd_nelmts
- N/OUT: Number of elements in cd_valuescd_values
- OUT: Auxiliary data for the filter.namelen
- IN: Anticipated number of characters in name.name
- OUT: Name of the filter.filter_config
- OUT: A bit field encoding the returned filter information- Returns:
- the filter identification number if successful. Otherwise returns H5Z_FILTER_ERROR (-1).
- Throws:
java.lang.ArrayIndexOutOfBoundsException
- Fatal error on Copybackjava.lang.ArrayStoreException
- Fatal error on CopybackHDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name or an array is null.
-
H5Pget_filter_by_id2
public static int H5Pget_filter_by_id2(int plist_id, int filter_id, int[] flags, long[] cd_nelmts, int[] cd_values, long namelen, java.lang.String[] name, int[] filter_config) throws HDF5LibraryException, java.lang.NullPointerException
H5Pget_filter_by_id2 returns information about a filter, specified by its filter id, in a filter pipeline, specified by the property list with which it is associated.- Parameters:
plist_id
- IN: Property list identifier.filter_id
- IN: Filter identifier.flags
- OUT: Bit vector specifying certain general properties of the filter.cd_nelmts
- N/OUT: Number of elements in cd_valuescd_values
- OUT: Auxiliary data for the filter.namelen
- IN: Anticipated number of characters in name.name
- OUT: Name of the filter.filter_config
- OUT: A bit field encoding the returned filter information- Returns:
- the filter identification number if successful. Otherwise returns H5Z_FILTER_ERROR (-1).
- Throws:
java.lang.ArrayIndexOutOfBoundsException
- Fatal error on Copybackjava.lang.ArrayStoreException
- Fatal error on CopybackHDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name or an array is null.- See Also:
H5Pget_filter_by_id(int, int, int[], long[], int[], long, java.lang.String[])
-
H5Pall_filters_avail
public static boolean H5Pall_filters_avail(int dcpl_id) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Premove_filter
public static int H5Premove_filter(int obj_id, int filter) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Pset_deflate
public static int H5Pset_deflate(int plist, int level) throws HDF5LibraryException
H5Pset_deflate sets the compression method for a dataset.- Parameters:
plist
- IN: Identifier for the dataset creation property list.level
- IN: Compression level.- Returns:
- non-negative if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_fletcher32
public static int H5Pset_fletcher32(int plist) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pget_userblock
public static int H5Pget_userblock(int plist, long[] size) throws HDF5LibraryException, java.lang.NullPointerException
H5Pget_userblock retrieves the size of a user block in a file creation property list.- Parameters:
plist
- IN: Identifier for property list to query.size
- OUT: Pointer to location to return user-block size.- Returns:
- a non-negative value and the size of the user block; if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - size is null.
-
H5Pset_userblock
public static int H5Pset_userblock(int plist, long size) throws HDF5LibraryException
H5Pset_userblock sets the user block size of a file creation property list.- Parameters:
plist
- IN: Identifier of property list to modify.size
- IN: Size of the user-block in bytes.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_sizes
public static int H5Pget_sizes(int plist, long[] size) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
H5Pget_sizes retrieves the size of the offsets and lengths used in an HDF5 file. This function is only valid for file creation property lists.- Parameters:
plist
- IN: Identifier of property list to query.size
- OUT: the size of the offsets and length.size[0] = sizeof_addr // offset size in bytes size[1] = sizeof_size // length size in bytes
- Returns:
- a non-negative value with the sizes initialized; if successful;
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - size is null.java.lang.IllegalArgumentException
- - size is invalid.
-
H5Pset_sizes
public static int H5Pset_sizes(int plist, int sizeof_addr, int sizeof_size) throws HDF5LibraryException
H5Pset_sizes sets the byte size of the offsets and lengths used to address objects in an HDF5 file.- Parameters:
plist
- IN: Identifier of property list to modify.sizeof_addr
- IN: Size of an object offset in bytes.sizeof_size
- IN: Size of an object length in bytes.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_sym_k
public static int H5Pget_sym_k(int plist, int[] size) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
H5Pget_sym_k retrieves the size of the symbol table B-tree 1/2 rank and the symbol table leaf node 1/2 size.- Parameters:
plist
- IN: Property list to query.size
- OUT: the symbol table's B-tree 1/2 rank and leaf node 1/2size.size[0] = ik // the symbol table's B-tree 1/2 rank size[1] = lk // leaf node 1/2 size
- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - size is null.java.lang.IllegalArgumentException
- - size is invalid.
-
H5Pset_sym_k
public static int H5Pset_sym_k(int plist, int ik, int lk) throws HDF5LibraryException
H5Pset_sym_k sets the size of parameters used to control the symbol table nodes.- Parameters:
plist
- IN: Identifier for property list to query.ik
- IN: Symbol table tree rank.lk
- IN: Symbol table node size.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_istore_k
public static int H5Pget_istore_k(int plist, int[] ik) throws HDF5LibraryException, java.lang.NullPointerException
H5Pget_istore_k queries the 1/2 rank of an indexed storage B-tree.- Parameters:
plist
- IN: Identifier of property list to query.ik
- OUT: Pointer to location to return the chunked storage B-tree 1/2 rank.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - ik array is null.
-
H5Pset_istore_k
public static int H5Pset_istore_k(int plist, int ik) throws HDF5LibraryException
H5Pset_istore_k sets the size of the parameter used to control the B-trees for indexing chunked datasets.- Parameters:
plist
- IN: Identifier of property list to query.ik
- IN: 1/2 rank of chunked storage B-tree.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_shared_mesg_nindexes
public static int H5Pget_shared_mesg_nindexes(int fcpl_id) throws HDF5LibraryException
H5Pget_shared_mesg_nindexes retrieves number of shared object header message indexes in file creation property list.- Parameters:
fcpl_id
- IN: : File creation property list identifier- Returns:
- nindexes, the number of shared object header message indexes available in files created with this property list
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_shared_mesg_nindexes
public static int H5Pset_shared_mesg_nindexes(int plist_id, int nindexes) throws HDF5LibraryException, java.lang.IllegalArgumentException
H5Pset_shared_mesg_nindexes sets the number of shared object header message indexes in the specified file creation property list.- Parameters:
plist_id
- IN: File creation property listnindexes
- IN: Number of shared object header message indexes to be available in files created with this property list- Returns:
- a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.IllegalArgumentException
- - Invalid value of nindexes
-
H5Pget_shared_mesg_index
public static int H5Pget_shared_mesg_index(int fcpl_id, int index_num, int[] mesg_info) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
H5Pget_shared_mesg_index Retrieves the configuration settings for a shared message index.- Parameters:
fcpl_id
- IN: File creation property list identifierindex_num
- IN: Index being configured.mesg_info
- The message type and minimum message sizemesg_info[0] = Types of messages that may be stored in this index. mesg_info[1] = Minimum message size.
- Returns:
- Returns a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - mesg_info is null.java.lang.IllegalArgumentException
- - Invalid value of nindexes
-
H5Pset_shared_mesg_index
public static int H5Pset_shared_mesg_index(int fcpl_id, int index_num, int mesg_type_flags, int min_mesg_size) throws HDF5LibraryException, java.lang.IllegalArgumentException
H5Pset_shared_mesg_index Configures the specified shared object header message index- Parameters:
fcpl_id
- IN: File creation property list identifier.index_num
- IN: Index being configured.mesg_type_flags
- IN: Types of messages that should be stored in this index.min_mesg_size
- IN: Minimum message size.- Returns:
- a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.IllegalArgumentException
- - Invalid value of nindexes
-
H5Pget_shared_mesg_phase_change
public static int H5Pget_shared_mesg_phase_change(int fcpl_id, int[] size) throws HDF5LibraryException, java.lang.NullPointerException
H5Pget_shared_mesg_phase_change retrieves shared object header message phase change information.- Parameters:
fcpl_id
- IN: : File creation property list identifiersize
- The threshold values for storage of shared object header message indexes in a file.size[0] = Threshold above which storage of a shared object header message index shifts from list to B-tree size[1] = Threshold below which storage of a shared object header message index reverts to list format
- Returns:
- Returns a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - size is null.
-
H5Pset_shared_mesg_phase_change
public static int H5Pset_shared_mesg_phase_change(int fcpl_id, int max_list, int min_btree) throws HDF5LibraryException, java.lang.IllegalArgumentException
H5Pset_shared_mesg_phase_change sets shared object header message storage phase change thresholds.- Parameters:
fcpl_id
- IN: File creation property list identifiermax_list
- IN: Threshold above which storage of a shared object header message index shifts from list to B-treemin_btree
- IN: Threshold below which storage of a shared object header message index reverts to list format- Returns:
- a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.IllegalArgumentException
- - Invalid values of max_list and min_btree.
-
H5Pget_alignment
public static int H5Pget_alignment(int plist, long[] alignment) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
H5Pget_alignment retrieves the current settings for alignment properties from a file access property list.- Parameters:
plist
- IN: Identifier of a file access property list.alignment
- OUT: threshold value and alignment value.alignment[0] = threshold // threshold value alignment[1] = alignment // alignment value
- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - aligment array is null.java.lang.IllegalArgumentException
- - aligment array is invalid.
-
H5Pset_alignment
public static int H5Pset_alignment(int plist, long threshold, long alignment) throws HDF5LibraryException
H5Pset_alignment sets the alignment properties of a file access property list so that any file object >= THRESHOLD bytes will be aligned on an address which is a multiple of ALIGNMENT.- Parameters:
plist
- IN: Identifier for a file access property list.threshold
- IN: Threshold value.alignment
- IN: Alignment value.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_driver
public static int H5Pget_driver(int plid) throws HDF5LibraryException
H5Pget_driver returns the identifier of the low-level file driver associated with the file access property list or data transfer property list plid.- Parameters:
plid
- IN: File access or data transfer property list identifier.- Returns:
- a valid low-level driver identifier if successful; a negative value if failed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_family_offset
public static long H5Pget_family_offset(int fapl_id) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pset_family_offset
public static int H5Pset_family_offset(int fapl_id, long offset) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pget_cache
public static int H5Pget_cache(int plist, int[] mdc_nelmts, long[] rdcc_nelmts, long[] rdcc_nbytes, double[] rdcc_w0) throws HDF5LibraryException, java.lang.NullPointerException
Retrieves the maximum possible number of elements in the meta data cache and the maximum possible number of bytes and the RDCC_W0 value in the raw data chunk cache.- Parameters:
plist
- IN: Identifier of the file access property list.mdc_nelmts
- IN/OUT: No longer used, will be ignored.rdcc_nelmts
- IN/OUT: Number of elements (objects) in the raw data chunk cache.rdcc_nbytes
- IN/OUT: Total size of the raw data chunk cache, in bytes.rdcc_w0
- IN/OUT: Preemption policy.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - an array is null.
-
H5Pget_cache
@Deprecated public static int H5Pget_cache(int plist, int[] mdc_nelmts, int[] rdcc_nelmts, int[] rdcc_nbytes, double[] rdcc_w0) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Pget_cache(int, int[], long[], long[], double[])
because of possible loss of precision- Parameters:
plist
- IN: Identifier of the file access property list.mdc_nelmts
- IN/OUT: No longer used, will be ignored.rdcc_nelmts
- IN/OUT: Number of elements (objects) in the raw data chunk cache.rdcc_nbytes
- IN/OUT: Total size of the raw data chunk cache, in bytes.rdcc_w0
- IN/OUT: Preemption policy.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - an array is null.
-
H5Pset_cache
public static int H5Pset_cache(int plist, int mdc_nelmts, long rdcc_nelmts, long rdcc_nbytes, double rdcc_w0) throws HDF5LibraryException
H5Pset_cache sets the number of elements (objects) in the meta data cache and the total number of bytes in the raw data chunk cache.- Parameters:
plist
- IN: Identifier of the file access property list.mdc_nelmts
- IN: No longer used, will be ignored.rdcc_nelmts
- IN: Number of elements (objects) in the raw data chunk cache.rdcc_nbytes
- IN: Total size of the raw data chunk cache, in bytes.rdcc_w0
- IN: Preemption policy.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_mdc_config
public static H5AC_cache_config_t H5Pget_mdc_config(int plist_id) throws HDF5LibraryException
H5Pget_mdc_config gets the initial metadata cache configuration contained in a file access property list and loads it into the instance of H5AC_cache_config_t pointed to by the config_ptr parameter. This configuration is used when the file is opened.- Parameters:
plist_id
- IN: Identifier of the file access property list.- Returns:
- A buffer(H5AC_cache_config_t) for the current metadata cache configuration information
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_mdc_config
public static void H5Pset_mdc_config(int plist_id, H5AC_cache_config_t config_ptr) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Pget_gc_references
public static int H5Pget_gc_references(int fapl_id, boolean[] gc_ref) throws HDF5LibraryException, java.lang.NullPointerException
H5Pget_gc_references Returns the current setting for the garbage collection refernces property from a file access property list.Note: this routine changed name with HDF5.1.2.2. If using an earlier version, use 'configure --enable-hdf5_1_2_1' so this routine will link to the old name.
- Parameters:
fapl_id
- IN File access property listgc_ref
- OUT GC is on (true) or off (false)- Returns:
- non-negative if succeed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - array is null.
-
H5Pget_gcreferences
public static boolean H5Pget_gcreferences(int fapl_id) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Pget_gc_reference
public static int H5Pget_gc_reference(int fapl_id, boolean[] gc_ref) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pset_gc_references
public static int H5Pset_gc_references(int fapl_id, boolean gc_ref) throws HDF5LibraryException
H5Pset_gc_references Sets the flag for garbage collecting references for the file. Default value for garbage collecting references is off.- Parameters:
fapl_id
- IN File access property listgc_ref
- IN set GC on (true) or off (false)- Returns:
- non-negative if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_fclose_degree
public static int H5Pget_fclose_degree(int plist_id) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pset_fclose_degree
public static int H5Pset_fclose_degree(int plist, int degree) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pget_meta_block_size
public static long H5Pget_meta_block_size(int fapl_id) throws HDF5LibraryException
H5Pget_meta_block_size the current metadata block size setting.- Parameters:
fapl_id
- IN: File access property list identifier- Returns:
- the minimum size, in bytes, of metadata block allocations.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_meta_block_size
public static void H5Pset_meta_block_size(int fapl_id, long size) throws HDF5LibraryException
H5Pset_meta_block_size sets the minimum metadata block size.- Parameters:
fapl_id
- IN: File access property list identifiersize
- IN: Minimum size, in bytes, of metadata block allocations.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_sieve_buf_size
public static long H5Pget_sieve_buf_size(int fapl_id) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Pset_sieve_buf_size
public static void H5Pset_sieve_buf_size(int fapl_id, long size) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Pget_small_data_block_size
public static int H5Pget_small_data_block_size(int plist, long[] size) throws HDF5LibraryException, java.lang.NullPointerException
H5Pget_small_data_block_size retrieves the size of a block of small data in a file creation property list.- Parameters:
plist
- IN: Identifier for property list to query.size
- OUT: Pointer to location to return block size.- Returns:
- a non-negative value and the size of the user block; if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - size is null.
-
H5Pget_small_data_block_size_long
public static long H5Pget_small_data_block_size_long(int plist) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Pset_small_data_block_size
public static int H5Pset_small_data_block_size(int plist, long size) throws HDF5LibraryException
H5Pset_small_data_block_size reserves blocks of size bytes for the contiguous storage of the raw data portion of small datasets.- Parameters:
plist
- IN: Identifier of property list to modify.size
- IN: Size of the blocks in bytes.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_libver_bounds
public static int H5Pget_libver_bounds(int fapl_id, int[] libver) throws HDF5LibraryException, java.lang.NullPointerException
H5Pget_libver_bounds retrieves the lower and upper bounds on the HDF5 Library versions that indirectly determine the object formats versions used when creating objects in the file.- Parameters:
fapl_id
- IN: File access property list identifierlibver
- The earliest/latest version of the library that will be used for writing objects.libver[0] = The earliest version of the library that will be used for writing objects libver[1] = The latest version of the library that will be used for writing objects.
- Returns:
- Returns a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - size is null.
-
H5Pset_libver_bounds
public static int H5Pset_libver_bounds(int fapl_id, int low, int high) throws HDF5LibraryException, java.lang.IllegalArgumentException
H5Pset_libver_bounds Sets bounds on library versions, and indirectly format versions, to be used when creating objects- Parameters:
fapl_id
- IN: File access property list identifierlow
- IN: The earliest version of the library that will be used for writing objectshigh
- IN: The latest version of the library that will be used for writing objects.- Returns:
- Returns a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.IllegalArgumentException
- - Argument is Illegal
-
H5Pget_elink_file_cache_size
public static int H5Pget_elink_file_cache_size(int fapl_id) throws HDF5LibraryException
H5Pget_elink_file_cache_size retrieves the size of the external link open file cache.- Parameters:
fapl_id
- IN: File access property list identifier- Returns:
- External link open file cache size in number of files.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_elink_file_cache_size
public static void H5Pset_elink_file_cache_size(int fapl_id, int efc_size) throws HDF5LibraryException
H5Pset_elink_file_cache_size sets the number of files that can be held open in an external link open file cache.- Parameters:
fapl_id
- IN: File access property list identifierefc_size
- IN: External link open file cache size in number of files.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_layout
public static int H5Pget_layout(int plist) throws HDF5LibraryException
H5Pget_layout returns the layout of the raw data for a dataset.- Parameters:
plist
- IN: Identifier for property list to query.- Returns:
- the layout type of a dataset creation property list if successful. Otherwise returns H5D_LAYOUT_ERROR (-1).
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_layout
public static int H5Pset_layout(int plist, int layout) throws HDF5LibraryException
H5Pset_layout sets the type of storage used store the raw data for a dataset.- Parameters:
plist
- IN: Identifier of property list to query.layout
- IN: Type of storage layout for raw data.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_chunk
public static int H5Pget_chunk(int plist, int max_ndims, long[] dims) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
H5Pget_chunk retrieves the size of chunks for the raw data of a chunked layout dataset.- Parameters:
plist
- IN: Identifier of property list to query.max_ndims
- IN: Size of the dims array.dims
- OUT: Array to store the chunk dimensions.- Returns:
- chunk dimensionality successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - dims array is null.java.lang.IllegalArgumentException
- - max_ndims <=0
-
H5Pset_chunk
public static int H5Pset_chunk(int plist, int ndims, byte[] dim) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
H5Pset_chunk sets the size of the chunks used to store a chunked layout dataset.- Parameters:
plist
- IN: Identifier for property list to query.ndims
- IN: The number of dimensions of each chunk.dim
- IN: An array containing the size of each chunk.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - dims array is null.java.lang.IllegalArgumentException
- - dims <=0
-
H5Pset_chunk
public static int H5Pset_chunk(int plist, int ndims, long[] dim) throws HDF5Exception, java.lang.NullPointerException, java.lang.IllegalArgumentException
- Throws:
HDF5Exception
java.lang.NullPointerException
java.lang.IllegalArgumentException
-
H5Pget_external
public static int H5Pget_external(int plist, int idx, long name_size, java.lang.String[] name, long[] size) throws java.lang.ArrayIndexOutOfBoundsException, java.lang.ArrayStoreException, HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
H5Pget_external returns information about an external file.- Parameters:
plist
- IN: Identifier of a dataset creation property list.idx
- IN: External file index.name_size
- IN: Maximum length of name array.name
- OUT: Name of the external file.size
- OUT: the offset value and the size of the external file data.size[0] = offset // a location to return an offset value size[1] = size // a location to return the size of // the external file data.
- Returns:
- a non-negative value if successful
- Throws:
java.lang.ArrayIndexOutOfBoundsException
- Fatal error on Copybackjava.lang.ArrayStoreException
- Fatal error on CopybackHDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name or size is null.java.lang.IllegalArgumentException
- - name_size <= 0 .
-
H5Pset_external
public static int H5Pset_external(int plist, java.lang.String name, long offset, long size) throws HDF5LibraryException, java.lang.NullPointerException
H5Pset_external adds an external file to the list of external files.- Parameters:
plist
- IN: Identifier of a dataset creation property list.name
- IN: Name of an external file.offset
- IN: Offset, in bytes, from the beginning of the file to the location in the file where the data starts.size
- IN: Number of bytes reserved in the file for the data.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Pget_external_count
public static int H5Pget_external_count(int plist) throws HDF5LibraryException
H5Pget_external_count returns the number of external files for the specified dataset.- Parameters:
plist
- IN: Identifier of a dataset creation property list.- Returns:
- the number of external files if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_szip
public static int H5Pset_szip(int plist, int options_mask, int pixels_per_block) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pset_shuffle
public static int H5Pset_shuffle(int plist_id) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pset_nbit
public static int H5Pset_nbit(int plist_id) throws HDF5LibraryException
H5Pset_nbit Sets up the use of the N-Bit filter.- Parameters:
plist_id
- IN: Dataset creation property list identifier.- Returns:
- a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_scaleoffset
public static int H5Pset_scaleoffset(int plist_id, int scale_type, int scale_factor) throws HDF5LibraryException, java.lang.IllegalArgumentException
H5Pset_scaleoffset sets the Scale-Offset filter for a dataset.- Parameters:
plist_id
- IN: Dataset creation property list identifier.scale_type
- IN: Flag indicating compression method.scale_factor
- IN: Parameter related to scale.- Returns:
- a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.IllegalArgumentException
- - Invalid arguments
-
H5Pget_fill_value
public static int H5Pget_fill_value(int plist_id, int type_id, byte[] value) throws HDF5Exception
H5Pget_fill_value queries the fill value property of a dataset creation property list.- Parameters:
plist_id
- IN: Property list identifier.type_id
- IN: The datatype identifier of value.value
- IN: The fill value.- Returns:
- a non-negative value if successful
- Throws:
HDF5Exception
- - Error converting data array.
-
H5Pget_fill_value
public static int H5Pget_fill_value(int plist_id, int type_id, java.lang.Object obj) throws HDF5Exception
H5Pget_fill_value queries the fill value property of a dataset creation property list.- Parameters:
plist_id
- IN: Property list identifier.type_id
- IN: The datatype identifier of value.obj
- IN: The fill value.- Returns:
- a non-negative value if successful
- Throws:
HDF5Exception
- - Error converting data array.
-
H5Pset_fill_value
public static int H5Pset_fill_value(int plist_id, int type_id, byte[] value) throws HDF5Exception
H5Pset_fill_value sets the fill value for a dataset creation property list.- Parameters:
plist_id
- IN: Property list identifier.type_id
- IN: The datatype identifier of value.value
- IN: The fill value.- Returns:
- a non-negative value if successful
- Throws:
HDF5Exception
- - Error converting data array
-
H5Pset_fill_value
public static int H5Pset_fill_value(int plist_id, int type_id, java.lang.Object obj) throws HDF5Exception
H5Pset_fill_value sets the fill value for a dataset creation property list.- Parameters:
plist_id
- IN: Property list identifier.type_id
- IN: The datatype identifier of value.obj
- IN: The fill value.- Returns:
- a non-negative value if successful
- Throws:
HDF5Exception
- - Error converting data array
-
H5Pfill_value_defined
public static int H5Pfill_value_defined(int plist_id, int[] status) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pget_alloc_time
public static int H5Pget_alloc_time(int plist_id, int[] alloc_time) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pset_alloc_time
public static int H5Pset_alloc_time(int plist_id, int alloc_time) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pget_fill_time
public static int H5Pget_fill_time(int plist_id, int[] fill_time) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pset_fill_time
public static int H5Pset_fill_time(int plist_id, int fill_time) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pget_chunk_cache
public static void H5Pget_chunk_cache(int dapl_id, long[] rdcc_nslots, long[] rdcc_nbytes, double[] rdcc_w0) throws HDF5LibraryException, java.lang.NullPointerException
Retrieves the maximum possible number of elements in the meta data cache and the maximum possible number of bytes and the RDCC_W0 value in the raw data chunk cache on a per-datset basis.- Parameters:
dapl_id
- IN: Identifier of the dataset access property list.rdcc_nslots
- IN/OUT: Number of elements (objects) in the raw data chunk cache.rdcc_nbytes
- IN/OUT: Total size of the raw data chunk cache, in bytes.rdcc_w0
- IN/OUT: Preemption policy.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - an array is null.
-
H5Pset_chunk_cache
public static void H5Pset_chunk_cache(int dapl_id, long rdcc_nslots, long rdcc_nbytes, double rdcc_w0) throws HDF5LibraryException
H5Pset_chunk_cache sets the number of elements (objects) in the meta data cache and the total number of bytes in the raw data chunk cache on a per-datset basis.- Parameters:
dapl_id
- IN: Identifier of the datset access property list.rdcc_nslots
- IN: Number of elements (objects) in the raw data chunk cache.rdcc_nbytes
- IN: Total size of the raw data chunk cache, in bytes.rdcc_w0
- IN: Preemption policy.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_data_transform
public static long H5Pget_data_transform(int plist_id, java.lang.String[] expression, long size) throws HDF5LibraryException, java.lang.IllegalArgumentException
H5Pget_data_transform retrieves the data transform expression previously set in the dataset transfer property list plist_id by H5Pset_data_transform.- Parameters:
plist_id
- IN: Identifier of the property list or classsize
- IN: Number of bytes of the transform expression to copy toexpression
- OUT: A data transform expression- Returns:
- The size of the transform expression if successful; 0(zero) if no transform expression exists. Otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.IllegalArgumentException
- - Size is <= 0.
-
H5Pset_data_transform
public static int H5Pset_data_transform(int plist_id, java.lang.String expression) throws HDF5LibraryException, java.lang.NullPointerException
H5Pset_data_transform sets a data transform expression- Parameters:
plist_id
- IN: Identifier of the property list or classexpression
- IN: Pointer to the null-terminated data transform expression- Returns:
- a non-negative valule if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - expression is null.
-
H5Pget_buffer
public static int H5Pget_buffer(int plist, byte[] tconv, byte[] bkg) throws HDF5LibraryException, java.lang.IllegalArgumentException
HH5Pget_buffer gets type conversion and background buffers. Returns buffer size, in bytes, if successful; otherwise 0 on failure.- Parameters:
plist
- Identifier for the dataset transfer property list.tconv
- byte array of application-allocated type conversion buffer.bkg
- byte array of application-allocated background buffer.- Returns:
- buffer size, in bytes, if successful; otherwise 0 on failure
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.IllegalArgumentException
- - plist is invalid.
-
H5Pget_buffer_size
public static long H5Pget_buffer_size(int plist) throws HDF5LibraryException, java.lang.IllegalArgumentException
- Throws:
HDF5LibraryException
java.lang.IllegalArgumentException
-
H5Pset_buffer_size
public static void H5Pset_buffer_size(int plist, long size) throws HDF5LibraryException, java.lang.IllegalArgumentException
H5Pset_buffer sets type conversion and background buffers. status to TRUE or FALSE. Given a dataset transfer property list, H5Pset_buffer sets the maximum size for the type conversion buffer and background buffer and optionally supplies pointers to application-allocated buffers. If the buffer size is smaller than the entire amount of data being transferred between the application and the file, and a type conversion buffer or background buffer is required, then strip mining will be used. Note that there are minimum size requirements for the buffer. Strip mining can only break the data up along the first dimension, so the buffer must be large enough to accommodate a complete slice that encompasses all of the remaining dimensions. For example, when strip mining a 100x200x300 hyperslab of a simple data space, the buffer must be large enough to hold 1x200x300 data elements. When strip mining a 100x200x300x150 hyperslab of a simple data space, the buffer must be large enough to hold 1x200x300x150 data elements.- Parameters:
plist
- Identifier for the dataset transfer property list.size
- Size, in bytes, of the type conversion and background buffers.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.IllegalArgumentException
- - plist is invalid.
-
H5Pget_edc_check
public static int H5Pget_edc_check(int plist) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pset_edc_check
public static int H5Pset_edc_check(int plist, int check) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pget_btree_ratios
public static int H5Pget_btree_ratios(int plist_id, double[] left, double[] middle, double[] right) throws HDF5LibraryException, java.lang.NullPointerException
H5Pget_btree_ratio Get the B-tree split ratios for a dataset transfer property list.- Parameters:
plist_id
- IN Dataset transfer property listleft
- OUT split ratio for leftmost nodesright
- OUT split ratio for righttmost nodesmiddle
- OUT split ratio for all other nodes- Returns:
- non-negative if succeed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - an input array is null.
-
H5Pset_btree_ratios
public static int H5Pset_btree_ratios(int plist_id, double left, double middle, double right) throws HDF5LibraryException
H5Pset_btree_ratio Sets B-tree split ratios for a dataset transfer property list. The split ratios determine what percent of children go in the first node when a node splits.- Parameters:
plist_id
- IN Dataset transfer property listleft
- IN split ratio for leftmost nodesright
- IN split ratio for righttmost nodesmiddle
- IN split ratio for all other nodes- Returns:
- non-negative if succeed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_hyper_vector_size
public static int H5Pget_hyper_vector_size(int dxpl_id, long[] vector_size) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pset_hyper_vector_size
public static int H5Pset_hyper_vector_size(int dxpl_id, long vector_size) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pget_create_intermediate_group
public static boolean H5Pget_create_intermediate_group(int lcpl_id) throws HDF5LibraryException
H5Pget_create_intermediate_group determines whether property is set to enable creating missing intermediate groups.- Parameters:
lcpl_id
- IN: Link creation property list identifier- Returns:
- Boolean true or false
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_create_intermediate_group
public static int H5Pset_create_intermediate_group(int lcpl_id, boolean crt_intermed_group) throws HDF5LibraryException
H5Pset_create_intermediate_group specifies in property list whether to create missing intermediate groups- Parameters:
lcpl_id
- IN: Link creation property list identifiercrt_intermed_group
- IN: Flag specifying whether to create intermediate groups upon the creation of an object- Returns:
- a non-negative valule if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_local_heap_size_hint
public static long H5Pget_local_heap_size_hint(int gcpl_id) throws HDF5LibraryException
H5Pget_local_heap_size_hint Retrieves the anticipated size of the local heap for original-style groups.- Parameters:
gcpl_id
- IN: Group creation property list identifier- Returns:
- size_hint, the anticipated size of local heap
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_local_heap_size_hint
public static int H5Pset_local_heap_size_hint(int gcpl_id, long size_hint) throws HDF5LibraryException
H5Pset_local_heap_size_hint Specifies the anticipated maximum size of a local heap.- Parameters:
gcpl_id
- IN: Group creation property list identifiersize_hint
- IN: Anticipated maximum size in bytes of local heap- Returns:
- a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_link_phase_change
public static int H5Pget_link_phase_change(int gcpl_id, int[] links) throws HDF5LibraryException, java.lang.NullPointerException
H5Pget_link_phase_change Queries the settings for conversion between compact and dense groups.- Parameters:
gcpl_id
- IN: Group creation property list identifierlinks
- The max. no. of compact links & the min. no. of dense links, which are used for storing groupslinks[0] = The maximum number of links for compact storage links[1] = The minimum number of links for dense storage
- Returns:
- Returns a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - size is null.
-
H5Pset_link_phase_change
public static int H5Pset_link_phase_change(int gcpl_id, int max_compact, int min_dense) throws HDF5LibraryException, java.lang.IllegalArgumentException
H5Pset_link_phase_change Sets the parameters for conversion between compact and dense groups.- Parameters:
gcpl_id
- IN: Group creation property list identifiermax_compact
- IN: Maximum number of links for compact storage(Default: 8)min_dense
- IN: Minimum number of links for dense storage(Default: 6)- Returns:
- a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.IllegalArgumentException
- - Invalid values of max_compact and min_dense.
-
H5Pget_est_link_info
public static int H5Pget_est_link_info(int gcpl_id, int[] link_info) throws HDF5LibraryException, java.lang.NullPointerException
H5Pget_est_link_info Queries data required to estimate required local heap or object header size.- Parameters:
gcpl_id
- IN: Group creation property list identifierlink_info
- Estimated number of links to be inserted into group And the estimated average length of link nameslink_info[0] = Estimated number of links to be inserted into group link_info[1] = Estimated average length of link names
- Returns:
- Returns a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - link_info is null.
-
H5Pset_est_link_info
public static int H5Pset_est_link_info(int gcpl_id, int est_num_entries, int est_name_len) throws HDF5LibraryException, java.lang.IllegalArgumentException
H5Pset_est_link_info Sets estimated number of links and length of link names in a group.- Parameters:
gcpl_id
- IN: Group creation property list identifierest_num_entries
- IN: Estimated number of links to be inserted into groupest_name_len
- IN: Estimated average length of link names- Returns:
- a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.IllegalArgumentException
- - Invalid values to est_num_entries and est_name_len.
-
H5Pget_link_creation_order
public static int H5Pget_link_creation_order(int gcpl_id) throws HDF5LibraryException
H5Pget_link_creation_order queries the group creation property list, gcpl_id, and returns a flag indicating whether link creation order is tracked and/or indexed in a group.- Parameters:
gcpl_id
- IN: Group creation property list identifier- Returns:
- crt_order_flags -Creation order flag(s)
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_link_creation_order
public static int H5Pset_link_creation_order(int gcpl_id, int crt_order_flags) throws HDF5LibraryException
H5Pset_link_creation_order Sets flags in a group creation property list, gcpl_id, for tracking and/or indexing links on creation order.- Parameters:
gcpl_id
- IN: Group creation property list identifiercrt_order_flags
- IN: Creation order flag(s)- Returns:
- Returns a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_char_encoding
public static int H5Pget_char_encoding(int plist_id) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Pset_char_encoding
public static void H5Pset_char_encoding(int plist_id, int encoding) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Pget_nlinks
public static long H5Pget_nlinks(int lapl_id) throws HDF5LibraryException
H5Pget_nlinks retrieves the maximum number of soft or user-defined link traversals allowed, nlinks, before the library assumes it has found a cycle and aborts the traversal. This value is retrieved from the link access property list lapl_id.- Parameters:
lapl_id
- IN: File access property list identifier- Returns:
- Returns a Maximum number of links to traverse.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_nlinks
public static int H5Pset_nlinks(int lapl_id, long nlinks) throws HDF5LibraryException, java.lang.IllegalArgumentException
H5Pset_nlinks sets the maximum number of soft or user-defined link traversals allowed, nlinks, before the library assumes it has found a cycle and aborts the traversal. This value is set in the link access property list lapl_id.- Parameters:
lapl_id
- IN: File access property list identifiernlinks
- IN: Maximum number of links to traverse- Returns:
- Returns a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.IllegalArgumentException
- - Argument is Illegal
-
H5Pget_elink_prefix
public static long H5Pget_elink_prefix(int lapl_id, java.lang.String[] prefix) throws HDF5LibraryException, java.lang.NullPointerException
H5Pget_elink_prefix Retrieves prefix applied to external link paths.- Parameters:
lapl_id
- IN: Link access property list identifierprefix
- OUT: Prefix applied to external link paths- Returns:
- If successful, returns a non-negative value specifying the size in bytes of the prefix without the NULL terminator; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - prefix is null.
-
H5Pset_elink_prefix
public static int H5Pset_elink_prefix(int lapl_id, java.lang.String prefix) throws HDF5LibraryException, java.lang.NullPointerException
H5Pset_elink_prefix Sets prefix to be applied to external link paths.- Parameters:
lapl_id
- IN: Link access property list identifierprefix
- IN: Prefix to be applied to external link paths- Returns:
- a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - prefix is null.
-
H5Pget_elink_fapl
public static int H5Pget_elink_fapl(int lapl_id) throws HDF5LibraryException
H5Pget_elink_fapl Retrieves the file access property list identifier associated with the link access property list.- Parameters:
lapl_id
- IN: Link access property list identifier- Returns:
- a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_elink_fapl
public static int H5Pset_elink_fapl(int lapl_id, int fapl_id) throws HDF5LibraryException
H5Pset_elink_fapl sets a file access property list for use in accessing a file pointed to by an external link.- Parameters:
lapl_id
- IN: Link access property list identifierfapl_id
- IN: File access property list identifier- Returns:
- a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_elink_acc_flags
public static int H5Pget_elink_acc_flags(int lapl_id) throws HDF5LibraryException
H5Pget_elink_acc_flags retrieves the external link traversal file access flag from the specified link access property list.- Parameters:
lapl_id
- IN: Link access property list identifier- Returns:
- File access flag for link traversal.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_elink_acc_flags
public static int H5Pset_elink_acc_flags(int lapl_id, int flags) throws HDF5LibraryException, java.lang.IllegalArgumentException
H5Pset_elink_acc_flags Sets the external link traversal file access flag in a link access property list.- Parameters:
lapl_id
- IN: Link access property list identifierflags
- IN: The access flag for external link traversal.- Returns:
- a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.IllegalArgumentException
- - Invalid Flag values.
-
H5Pget_copy_object
public static int H5Pget_copy_object(int ocp_plist_id) throws HDF5LibraryException
H5Pget_copy_object retrieves the properties to be used when an object is copied.- Parameters:
ocp_plist_id
- IN: Object copy property list identifier- Returns:
- Copy option(s) set in the object copy property list
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_copy_object
public static void H5Pset_copy_object(int ocp_plist_id, int copy_options) throws HDF5LibraryException
H5Pset_copy_object Sets properties to be used when an object is copied.- Parameters:
ocp_plist_id
- IN: Object copy property list identifiercopy_options
- IN: Copy option(s) to be set- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_version
public static int H5Pget_version(int plist, int[] version_info) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
H5Pget_version retrieves the version information of various objects for a file creation property list.- Parameters:
plist
- IN: Identifier of the file creation property list.version_info
- OUT: version information.version_info[0] = boot // boot block version number version_info[1] = freelist // global freelist version version_info[2] = stab // symbol tabl version number version_info[3] = shhdr // shared object header version
- Returns:
- a non-negative value, with the values of version_info initialized, if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - version_info is null.java.lang.IllegalArgumentException
- - version_info is illegal.
-
H5Pget_fapl_core
public static void H5Pget_fapl_core(int fapl_id, long[] increment, boolean[] backing_store) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pset_fapl_core
public static int H5Pset_fapl_core(int fapl_id, long increment, boolean backing_store) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pget_fapl_direct
public static int H5Pget_fapl_direct(int fapl_id, long[] info) throws HDF5LibraryException
H5Pget_fapl_direct Retrieve direct I/O settings.- Parameters:
fapl_id
- IN: File access property list identifierinfo
- OUT: Returned property list information info[0] = alignment Required memory alignment boundary info[1] = block_size File system block size info[2] = cbuf_size Copy buffer size- Returns:
- a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_fapl_direct
public static int H5Pset_fapl_direct(int fapl_id, long alignment, long block_size, long cbuf_size) throws HDF5LibraryException
H5Pset_fapl_direct Sets up use of the direct I/O driver.- Parameters:
fapl_id
- IN: File access property list identifieralignment
- IN: Required memory alignment boundaryblock_size
- IN: File system block sizecbuf_size
- IN: Copy buffer size- Returns:
- a non-negative value if successful; otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pget_fapl_family
public static int H5Pget_fapl_family(int fapl_id, long[] memb_size, int[] memb_fapl_id) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pset_fapl_family
public static int H5Pset_fapl_family(int fapl_id, long memb_size, int memb_fapl_id) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pget_fapl_multi
public static boolean H5Pget_fapl_multi(int fapl_id, int[] memb_map, int[] memb_fapl, java.lang.String[] memb_name, long[] memb_addr) throws HDF5LibraryException, java.lang.NullPointerException
H5Pget_fapl_multi Sets up use of the multi I/O driver.- Parameters:
fapl_id
- IN: File access property list identifiermemb_map
- IN: Maps memory usage types to other memory usage types.memb_fapl
- IN: Property list for each memory usage type.memb_name
- IN: Name generator for names of member files.memb_addr
- IN: The offsets within the virtual address space, from 0 (zero) to HADDR_MAX, at which each type of data storage begins.- Returns:
- a boolean value; Allows read-only access to incomplete file sets when TRUE.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - an array is null.
-
H5Pset_fapl_multi
public static void H5Pset_fapl_multi(int fapl_id, int[] memb_map, int[] memb_fapl, java.lang.String[] memb_name, long[] memb_addr, boolean relax) throws HDF5LibraryException, java.lang.NullPointerException
H5Pset_fapl_multi Sets up use of the multi I/O driver.- Parameters:
fapl_id
- IN: File access property list identifiermemb_map
- IN: Maps memory usage types to other memory usage types.memb_fapl
- IN: Property list for each memory usage type.memb_name
- IN: Name generator for names of member files.memb_addr
- IN: The offsets within the virtual address space, from 0 (zero) to HADDR_MAX, at which each type of data storage begins.relax
- IN: Allows read-only access to incomplete file sets when TRUE.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - an array is null.
-
H5Pget_preserve
@Deprecated public static int H5Pget_preserve(int plist) throws HDF5LibraryException
Deprecated.As of HDF5 1.8, compound datatype field preservation is now core functionality in the HDF5 Library.H5Pget_preserve checks the status of the dataset transfer property list.- Parameters:
plist
- IN: Identifier for the dataset transfer property list.- Returns:
- TRUE or FALSE if successful; otherwise returns a negative value
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Pset_preserve
@Deprecated public static int H5Pset_preserve(int plist, boolean status) throws HDF5LibraryException, java.lang.IllegalArgumentException
Deprecated.As of HDF5 1.8, compound datatype field preservation is now core functionality in the HDF5 Library.H5Pset_preserve sets the dataset transfer property list status to TRUE or FALSE.- Parameters:
plist
- IN: Identifier for the dataset transfer property list.status
- IN: Status of for the dataset transfer property list.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.IllegalArgumentException
- - plist is invalid.
-
H5Pset_fapl_log
@Deprecated public static int H5Pset_fapl_log(int fapl_id, java.lang.String logfile, int flags, int buf_size) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8.7, replaced byH5Pset_fapl_log(int, String, long, long)
H5Pset_fapl_log Sets up the logging virtual file driver (H5FD_LOG) for use. H5Pset_fapl_log modifies the file access property list to use the logging driver, H5FD_LOG. The logging virtual file driver (VFD) is a clone of the standard SEC2 (H5FD_SEC2) driver with additional facilities for logging VFD metrics and activity to a file.- Parameters:
fapl_id
- IN: File access property list identifier.logfile
- IN: logfile is the name of the file in which the logging entries are to be recorded.flags
- IN: Flags specifying the types of logging activity.buf_size
- IN: The size of the logging buffers, in bytes.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - logfile is null.
-
H5Pset_fapl_log
public static void H5Pset_fapl_log(int fapl_id, java.lang.String logfile, long flags, long buf_size) throws HDF5LibraryException, java.lang.NullPointerException
H5Pset_fapl_log Sets up the logging virtual file driver (H5FD_LOG) for use. H5Pset_fapl_log modifies the file access property list to use the logging driver, H5FD_LOG. The logging virtual file driver (VFD) is a clone of the standard SEC2 (H5FD_SEC2) driver with additional facilities for logging VFD metrics and activity to a file.- Parameters:
fapl_id
- IN: File access property list identifier.logfile
- IN: logfile is the name of the file in which the logging entries are to be recorded.flags
- IN: Flags specifying the types of logging activity.buf_size
- IN: The size of the logging buffers, in bytes.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - logfile is null.
-
H5Pset_fapl_sec2
public static int H5Pset_fapl_sec2(int fapl_id) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pset_fapl_split
public static void H5Pset_fapl_split(int fapl_id, java.lang.String meta_ext, int meta_plist_id, java.lang.String raw_ext, int raw_plist_id) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pset_fapl_stdio
public static int H5Pset_fapl_stdio(int fapl_id) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Pset_fapl_windows
public static int H5Pset_fapl_windows(int fapl_id) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5PLset_loading_state
public static void H5PLset_loading_state(int plugin_flags) throws HDF5LibraryException
H5PLset_loading_state uses one argument to enable or disable individual plugins. The plugin_flags parameter is an encoded integer in which each bit controls a specific plugin or class of plugins. A plugin bit set to 0 (zero) prevents the use of the dynamic plugin corresponding to that bit position. A plugin bit set to 1 (one) allows the use of that dynamic plugin. All dynamic plugins can be enabled by setting plugin_flags to a negative value. A value of 0 (zero) will disable all dynamic plugins. H5PLset_loading_state inspects the HDF5_PLUGIN_PRELOAD environment variable every time it is called. If the environment variable is set to the special :: string, all dynamic plugins will be disabled.- Parameters:
plugin_flags
- IN: The list of dynamic plugin types to enable or disable. A plugin bit set to 0 (zero) prevents use of that dynamic plugin. A plugin bit set to 1 (one) enables use of that dynamic plugin. Setting plugin_flags to a negative value enables all dynamic plugins. Setting plugin_flags to 0 (zero) disables all dynamic plugins.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5PLget_loading_state
public static int H5PLget_loading_state() throws HDF5LibraryException
H5PLget_loading_state retrieves the state of the dynamic plugins flag, plugin_flags..- Returns:
- the list of dynamic plugin types that are enabled or disabled. A plugin bit set to 0 (zero) indicates that that dynamic plugin is disabled. A plugin bit set to 1 (one) indicates that that dynamic plugin is enabled. If the value of plugin_flags is negative, all dynamic plugins are enabled. If the value of plugin_flags is 0 (zero), all dynamic plugins are disabled.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Rcreate
public static byte[] H5Rcreate(int loc_id, java.lang.String name, int ref_type, int space_id) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
H5Rcreate creates the reference, ref, of the type specified in ref_type, pointing to the object name located at loc_id.- Parameters:
loc_id
- IN: Location identifier used to locate the object being pointed to.name
- IN: Name of object at location loc_id.ref_type
- IN: Type of reference.space_id
- IN: Dataspace identifier with selection.- Returns:
- the reference (byte[]) if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - an input array is null.java.lang.IllegalArgumentException
- - an input array is invalid.
-
H5Rdereference
public static int H5Rdereference(int dataset, int ref_type, byte[] ref) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
Given a reference to some object, H5Rdereference opens that object and return an identifier.- Parameters:
dataset
- IN: Dataset containing reference object.ref_type
- IN: The reference type of ref.ref
- IN: reference to an object- Returns:
- valid identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - output array is null.java.lang.IllegalArgumentException
- - output array is invalid.
-
H5Rget_name
public static long H5Rget_name(int loc_id, int ref_type, byte[] ref, java.lang.String[] name, long size) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
H5Rget_name retrieves a name for the object identified by ref.- Parameters:
loc_id
- IN: Identifier for the dataset containing the reference or for the group that dataset is in.ref_type
- IN: Type of reference.ref
- IN: An object or dataset region reference.name
- OUT: A name associated with the referenced object or dataset region.size
- IN: The size of the name buffer.- Returns:
- Returns the length of the name if successful, returning 0 (zero) if no name is associated with the identifier. Otherwise returns a negative value.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - size is null.java.lang.IllegalArgumentException
- - Argument is illegal.
-
H5Rget_obj_type
@Deprecated public static int H5Rget_obj_type(int loc_id, int ref_type, byte[] ref) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
Deprecated.As of HDF5 1.8, replaced byH5Rget_obj_type(int, int, byte[], int[])
Given a reference to an object ref, H5Rget_obj_type returns the type of the object pointed to.- Parameters:
loc_id
- IN: loc_id of the reference object.ref_type
- IN: Type of reference to query. *ref
- IN: the reference- Returns:
- a valid object type if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - array is null.java.lang.IllegalArgumentException
- - array is invalid.
-
H5Rget_obj_type
public static int H5Rget_obj_type(int loc_id, int ref_type, byte[] ref, int[] obj_type) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
H5Rget_obj_type Given a reference to an object ref, H5Rget_obj_type returns the type of the object pointed to.- Parameters:
loc_id
- IN: loc_id of the reference object.ref_type
- IN: Type of reference to query.ref
- IN: the referenceobj_type
- OUT:Type of referenced object- Returns:
- Returns the object type, which is the same as obj_type[0]. The return value is the same as the HDF5 1.6 version.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - array is null.java.lang.IllegalArgumentException
- - array is invalid.
-
H5Rget_region
public static int H5Rget_region(int loc_id, int ref_type, byte[] ref) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
Given a reference to an object ref, H5Rget_region creates a copy of the dataspace of the dataset pointed to and defines a selection in the copy which is the region pointed to.- Parameters:
loc_id
- IN: loc_id of the reference object.ref_type
- IN: The reference type of ref.ref
- OUT: the reference to the object and region- Returns:
- a valid identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - output array is null.java.lang.IllegalArgumentException
- - output array is invalid.
-
H5Sclose
public static int H5Sclose(int space_id) throws HDF5LibraryException
H5Sclose releases a dataspace.- Parameters:
space_id
- Identifier of dataspace to release.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Scopy
public static int H5Scopy(int space_id) throws HDF5LibraryException
H5Scopy creates a new dataspace which is an exact copy of the dataspace identified by space_id.- Parameters:
space_id
- Identifier of dataspace to copy.- Returns:
- a dataspace identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Screate
public static int H5Screate(int type) throws HDF5LibraryException
H5Screate creates a new dataspace of a particular type.- Parameters:
type
- IN: The type of dataspace to be created.- Returns:
- a dataspace identifier
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Screate_simple
public static int H5Screate_simple(int rank, long[] dims, long[] maxdims) throws HDF5Exception, java.lang.NullPointerException
H5Screate_simple creates a new simple data space and opens it for access.- Parameters:
rank
- IN: Number of dimensions of dataspace.dims
- IN: An array of the size of each dimension.maxdims
- IN: An array of the maximum size of each dimension.- Returns:
- a dataspace identifier
- Throws:
HDF5Exception
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - dims or maxdims is null.
-
H5Screate_simple
@Deprecated public static int H5Screate_simple(int rank, byte[] dims, byte[] maxdims) throws HDF5Exception, java.lang.NullPointerException
Deprecated.use H5Screate_simple(int rank, long[] dims, long[] maxdims)- Parameters:
rank
- IN: Number of dimensions of dataspace.dims
- IN: An array of the size of each dimension.maxdims
- IN: An array of the maximum size of each dimension.- Returns:
- a dataspace identifier
- Throws:
HDF5Exception
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - dims or maxdims is null.
-
H5Sdecode
public static int H5Sdecode(byte[] buf) throws HDF5LibraryException, java.lang.NullPointerException
H5Sdecode reconstructs the HDF5 data space object and returns a new object handle for it.- Parameters:
buf
- IN: Buffer for the data space object to be decoded.- Returns:
- a new object handle
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - buf is null.
-
H5Sencode
public static byte[] H5Sencode(int obj_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Sencode converts a data space description into binary form in a buffer.- Parameters:
obj_id
- IN: Identifier of the object to be encoded.- Returns:
- the buffer for the object to be encoded into.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
-
H5Sextent_copy
public static int H5Sextent_copy(int dest_space_id, int source_space_id) throws HDF5LibraryException
H5Sextent_copy copies the extent from source_space_id to dest_space_id. This action may change the type of the dataspace.- Parameters:
dest_space_id
- IN: The identifier for the dataspace from which the extent is copied.source_space_id
- IN: The identifier for the dataspace to which the extent is copied.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Sextent_equal
public static boolean H5Sextent_equal(int first_space_id, int second_space_id) throws HDF5LibraryException
H5Sextent_equal determines whether the dataspace extents of two dataspaces, space1_id and space2_id, are equal.- Parameters:
first_space_id
- IN: The identifier for the first dataspace.second_space_id
- IN: The identifier for the seconddataspace.- Returns:
- true if successful, else false
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Sget_select_bounds
public static int H5Sget_select_bounds(int spaceid, long[] start, long[] end) throws HDF5LibraryException, java.lang.NullPointerException
H5Sget_select_bounds retrieves the coordinates of the bounding box containing the current selection and places them into user-supplied buffers.The start and end buffers must be large enough to hold the dataspace rank number of coordinates.
- Parameters:
spaceid
- Identifier of dataspace to release.start
- coordinates of lowest corner of bounding box.end
- coordinates of highest corner of bounding box.- Returns:
- a non-negative value if successful,with start and end initialized.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - start or end is null.
-
H5Sget_select_elem_npoints
public static long H5Sget_select_elem_npoints(int spaceid) throws HDF5LibraryException
H5Sget_select_elem_npoints returns the number of element points in the current dataspace selection.- Parameters:
spaceid
- Identifier of dataspace to release.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Sget_select_elem_pointlist
public static int H5Sget_select_elem_pointlist(int spaceid, long startpoint, long numpoints, long[] buf) throws HDF5LibraryException, java.lang.NullPointerException
H5Sget_select_elem_pointlist returns an array of of element points in the current dataspace selection. The point coordinates have the same dimensionality (rank) as the dataspace they are located within, one coordinate per point.- Parameters:
spaceid
- Identifier of dataspace to release.startpoint
- first point to retrievenumpoints
- number of points to retrievebuf
- returns points startblock to startblock+num-1, each points is rank longs.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - buf is null.
-
H5Sget_select_hyper_blocklist
public static int H5Sget_select_hyper_blocklist(int spaceid, long startblock, long numblocks, long[] buf) throws HDF5LibraryException, java.lang.NullPointerException
H5Sget_select_hyper_blocklist returns an array of hyperslab blocks. The block coordinates have the same dimensionality (rank) as the dataspace they are located within. The list of blocks is formatted as follows:<"start" coordinate>, immediately followed by <"opposite" corner coordinate>, followed by the next "start" and "opposite" coordinates, etc. until all of the selected blocks have been listed.
- Parameters:
spaceid
- Identifier of dataspace to release.startblock
- first block to retrievenumblocks
- number of blocks to retrievebuf
- returns blocks startblock to startblock+num-1, each block is rank * 2 (corners) longs.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - buf is null.
-
H5Sget_select_hyper_nblocks
public static long H5Sget_select_hyper_nblocks(int spaceid) throws HDF5LibraryException
H5Sget_select_hyper_nblocks returns the number of hyperslab blocks in the current dataspace selection.- Parameters:
spaceid
- Identifier of dataspace to release.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Sget_select_npoints
public static long H5Sget_select_npoints(int space_id) throws HDF5LibraryException
H5Sget_select_npoints determines the number of elements in the current selection of a dataspace.- Parameters:
space_id
- IN: Identifier of the dataspace object to query- Returns:
- the number of elements in the selection if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Sget_select_type
public static int H5Sget_select_type(int space_id) throws HDF5LibraryException
H5Sget_select_type retrieves the type of selection currently defined for the dataspace space_id.- Parameters:
space_id
- IN: Identifier of the dataspace object to query- Returns:
- the dataspace selection type if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Sget_simple_extent_dims
public static int H5Sget_simple_extent_dims(int space_id, long[] dims, long[] maxdims) throws HDF5LibraryException, java.lang.NullPointerException
H5Sget_simple_extent_dims returns the size and maximum sizes of each dimension of a dataspace through the dims and maxdims parameters.- Parameters:
space_id
- IN: Identifier of the dataspace object to querydims
- OUT: Pointer to array to store the size of each dimension.maxdims
- OUT: Pointer to array to store the maximum size of each dimension.- Returns:
- the number of dimensions in the dataspace if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - dims or maxdims is null.
-
H5Sget_simple_extent_ndims
public static int H5Sget_simple_extent_ndims(int space_id) throws HDF5LibraryException
H5Sget_simple_extent_ndims determines the dimensionality (or rank) of a dataspace.- Parameters:
space_id
- IN: Identifier of the dataspace- Returns:
- the number of dimensions in the dataspace if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Sget_simple_extent_npoints
public static long H5Sget_simple_extent_npoints(int space_id) throws HDF5LibraryException
H5Sget_simple_extent_npoints determines the number of elements in a dataspace.- Parameters:
space_id
- ID of the dataspace object to query- Returns:
- the number of elements in the dataspace if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Sget_simple_extent_type
public static int H5Sget_simple_extent_type(int space_id) throws HDF5LibraryException
H5Sget_simple_extent_type queries a dataspace to determine the current class of a dataspace.- Parameters:
space_id
- Dataspace identifier.- Returns:
- a dataspace class name if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Sis_simple
public static boolean H5Sis_simple(int space_id) throws HDF5LibraryException
H5Sis_simple determines whether a dataspace is a simple dataspace.- Parameters:
space_id
- Identifier of the dataspace to query- Returns:
- true if is a simple dataspace
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Soffset_simple
public static int H5Soffset_simple(int space_id, byte[] offset) throws HDF5LibraryException, java.lang.NullPointerException
H5Soffset_simple sets the offset of a simple dataspace space_id.- Parameters:
space_id
- IN: The identifier for the dataspace object to reset.offset
- IN: The offset at which to position the selection.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - offset array is null.
-
H5Soffset_simple
public static int H5Soffset_simple(int space_id, long[] offset) throws HDF5Exception, java.lang.NullPointerException
- Throws:
HDF5Exception
java.lang.NullPointerException
-
H5Sselect_all
public static int H5Sselect_all(int space_id) throws HDF5LibraryException
H5Sselect_all selects the entire extent of the dataspace space_id.- Parameters:
space_id
- IN: The identifier of the dataspace to be selected.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Sselect_elements
public static int H5Sselect_elements(int space_id, int op, int num_elements, long[][] coord2D) throws HDF5Exception, HDF5LibraryException, java.lang.NullPointerException
H5Sselect_elements selects array elements to be included in the selection for the space_id dataspace.- Parameters:
space_id
- Identifier of the dataspace.op
- operator specifying how the new selection is combined.num_elements
- Number of elements to be selected.coord2D
- A 2-dimensional array specifying the coordinates of the elements.- Returns:
- a non-negative value if successful
- Throws:
HDF5Exception
- - Error in the data conversionHDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - cord array is
-
H5Sselect_hyperslab
public static int H5Sselect_hyperslab(int space_id, int op, byte[] start, byte[] stride, byte[] count, byte[] block) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
H5Sselect_hyperslab selects a hyperslab region to add to the current selected region for the dataspace specified by space_id. The start, stride, count, and block arrays must be the same size as the rank of the dataspace.- Parameters:
space_id
- IN: Identifier of dataspace selection to modifyop
- IN: Operation to perform on current selection.start
- IN: Offset of start of hyperslabstride
- IN: Hyperslab stride.count
- IN: Number of blocks included in hyperslab.block
- IN: Size of block in hyperslab.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - an input array is null.java.lang.IllegalArgumentException
- - an input array is invalid.
-
H5Sselect_hyperslab
public static int H5Sselect_hyperslab(int space_id, int op, long[] start, long[] stride, long[] count, long[] block) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
java.lang.IllegalArgumentException
-
H5Sselect_none
public static int H5Sselect_none(int space_id) throws HDF5LibraryException
H5Sselect_none resets the selection region for the dataspace space_id to include no elements.- Parameters:
space_id
- IN: The identifier of the dataspace to be reset.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Sselect_valid
public static boolean H5Sselect_valid(int space_id) throws HDF5LibraryException
H5Sselect_valid verifies that the selection for the dataspace.- Parameters:
space_id
- The identifier for the dataspace in which the selection is being reset.- Returns:
- true if the selection is contained within the extent and FALSE if it is not or is an error.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Sset_extent_none
public static int H5Sset_extent_none(int space_id) throws HDF5LibraryException
H5Sset_extent_none removes the extent from a dataspace and sets the type to H5S_NONE.- Parameters:
space_id
- The identifier for the dataspace from which the extent is to be removed.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Sset_extent_simple
public static int H5Sset_extent_simple(int space_id, int rank, long[] current_size, long[] maximum_size) throws HDF5LibraryException, java.lang.NullPointerException
H5Sset_extent_simple sets or resets the size of an existing dataspace.- Parameters:
space_id
- Dataspace identifier.rank
- Rank, or dimensionality, of the dataspace.current_size
- Array containing current size of dataspace.maximum_size
- Array containing maximum size of dataspace.- Returns:
- a dataspace identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
-
H5Sset_extent_simple
public static int H5Sset_extent_simple(int space_id, int rank, byte[] current_size, byte[] maximum_size) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Tarray_create
@Deprecated public static int H5Tarray_create(int base, int rank, int[] dims, int[] perms) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Tarray_create(int, int, long[])
H5Tarray_create creates a new array datatype object.- Parameters:
base
- IN: Datatype identifier for the array base datatype.rank
- IN: Rank of the array.dims
- IN: Size of each array dimension.perms
- IN: Dimension permutation. (Currently not implemented.)- Returns:
- a valid datatype identifier
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - dims is null.
-
H5Tarray_create
public static int H5Tarray_create(int base_id, int ndims, long[] dim) throws HDF5LibraryException, java.lang.NullPointerException
H5Tarray_create creates a new array datatype object.- Parameters:
base_id
- IN: Datatype identifier for the array base datatype.ndims
- IN: Rank of the array.dim
- IN: Size of each array dimension.- Returns:
- a valid datatype identifier
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - dim is null.
-
H5Tclose
public static int H5Tclose(int type_id) throws HDF5LibraryException
H5Tclose releases a datatype.- Parameters:
type_id
- IN: Identifier of datatype to release.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tcommit
@Deprecated public static int H5Tcommit(int loc_id, java.lang.String name, int type_id) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Tcommit(int, String, int, int, int, int)
H5Tcommit commits a transient datatype (not immutable) to a file, turned it into a named datatype.- Parameters:
loc_id
- IN: Location identifier.name
- IN: Name given to committed datatype.type_id
- IN: Identifier of datatype to be committed.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Tcommit1
@Deprecated public static int H5Tcommit1(int loc_id, java.lang.String name, int type) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Tcommit
public static void H5Tcommit(int loc_id, java.lang.String name, int type_id, int lcpl_id, int tcpl_id, int tapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Tcommit saves a transient datatype as an immutable named datatype in a file.- Parameters:
loc_id
- IN: Location identifier.name
- IN: Name given to committed datatype.type_id
- IN: Identifier of datatype to be committed.lcpl_id
- IN: Link creation property list.tcpl_id
- IN: Datatype creation property list.tapl_id
- IN: Datatype access property list.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Tcommit_anon
public static void H5Tcommit_anon(int loc_id, int type_id, int tcpl_id, int tapl_id) throws HDF5LibraryException
H5Tcommit_anon commits a transient datatype (not immutable) to a file, turning it into a named datatype with the specified creation and property lists.- Parameters:
loc_id
- IN: Location identifier.type_id
- IN: Identifier of datatype to be committed.tcpl_id
- IN: Datatype creation property list.tapl_id
- IN: Datatype access property list.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tcommitted
public static boolean H5Tcommitted(int type_id) throws HDF5LibraryException
H5Tcommitted queries a type to determine whether the type specified by the type identifier is a named type or a transient type.- Parameters:
type_id
- IN: Identifier of datatype.- Returns:
- true the datatype has been committed
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tcompiler_conv
public static void H5Tcompiler_conv(int src_id, int dst_id) throws HDF5LibraryException
H5Tcompiler_conv finds out whether the library's conversion function from type src_id to type dst_id is a compiler (hard) conversion.- Parameters:
src_id
- IN: Identifier of source datatype.dst_id
- IN: Identifier of destination datatype.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tconvert
public static void H5Tconvert(int src_id, int dst_id, long nelmts, byte[] buf, byte[] background, int plist_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Tconvert converts nelmts elements from the type specified by the src_id identifier to type dst_id.- Parameters:
src_id
- IN: Identifier of source datatype.dst_id
- IN: Identifier of destination datatype.nelmts
- IN: Size of array buf.buf
- IN: Array containing pre- and post-conversion values.background
- IN: Optional background buffer.plist_id
- IN: Dataset transfer property list identifier.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - buf is null.
-
H5Tcopy
public static int H5Tcopy(int type_id) throws HDF5LibraryException
H5Tcopy copies an existing datatype. The returned type is always transient and unlocked.- Parameters:
type_id
- IN: Identifier of datatype to copy. Can be a datatype identifier, a predefined datatype (defined in H5Tpublic.h), or a dataset Identifier.- Returns:
- a datatype identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tcreate
public static int H5Tcreate(int dclass, int size) throws HDF5LibraryException
H5Tcreate creates a new dataype of the specified class with the specified number of bytes.- Parameters:
dclass
- IN: Class of datatype to create.size
- IN: The number of bytes in the datatype to create.- Returns:
- datatype identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tcreate
public static int H5Tcreate(int tclass, long size) throws HDF5LibraryException
H5Tcreate creates a new dataype of the specified class with the specified number of bytes.- Parameters:
tclass
- IN: Class of datatype to create.size
- IN: The number of bytes in the datatype to create.- Returns:
- datatype identifier
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tdecode
public static int H5Tdecode(byte[] buf) throws HDF5LibraryException, java.lang.NullPointerException
H5Tdecode reconstructs the HDF5 data type object and returns a new object handle for it.- Parameters:
buf
- IN: Buffer for the data type object to be decoded.- Returns:
- a new object handle
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - buf is null.
-
H5Tdetect_class
public static boolean H5Tdetect_class(int type_id, int cls) throws HDF5LibraryException
H5Tdetect_class determines whether the datatype specified in dtype_id contains any datatypes of the datatype class specified in dtype_class.- Parameters:
type_id
- IN: Identifier of datatype to query.cls
- IN: Identifier of datatype cls.- Returns:
- true if the datatype specified in dtype_id contains any datatypes of the datatype class
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tencode
public static int H5Tencode(int obj_id, byte[] buf, long nalloc) throws HDF5LibraryException, java.lang.NullPointerException
H5Tencode converts a data type description into binary form in a buffer.- Parameters:
obj_id
- IN: Identifier of the object to be encoded.buf
- OUT: Buffer for the object to be encoded into. If the provided buffer is NULL, only the size of buffer needed is returned.nalloc
- IN: The size of the allocated buffer.- Returns:
- the size needed for the allocated buffer.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - buf is null.
-
H5Tenum_create
public static int H5Tenum_create(int base_id) throws HDF5LibraryException
H5Tenum_create creates a new enumeration datatype based on the specified base datatype, parent_id, which must be an integer type.- Parameters:
base_id
- IN: Identifier of the parent datatype to release.- Returns:
- the datatype identifier for the new enumeration datatype
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tenum_insert
public static void H5Tenum_insert(int type, java.lang.String name, byte[] value) throws HDF5LibraryException, java.lang.NullPointerException
H5Tenum_insert inserts a new enumeration datatype member into an enumeration datatype.- Parameters:
type
- IN: Identifier of datatype.name
- IN: The name of the membervalue
- IN: The value of the member, data of the correct type- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Tenum_insert
public static int H5Tenum_insert(int type, java.lang.String name, int[] value) throws HDF5LibraryException, java.lang.NullPointerException
H5Tenum_insert inserts a new enumeration datatype member into an enumeration datatype.- Parameters:
type
- IN: Identifier of datatype.name
- IN: The name of the membervalue
- IN: The value of the member, data of the correct type- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Tenum_insert
public static int H5Tenum_insert(int type, java.lang.String name, int value) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Tenum_nameof
public static java.lang.String H5Tenum_nameof(int type, byte[] value, long size) throws HDF5LibraryException, java.lang.NullPointerException
H5Tenum_nameof finds the symbol name that corresponds to the specified value of the enumeration datatype type.- Parameters:
type
- IN: Identifier of datatype.value
- IN: The value of the member, data of the correctsize
- IN: The probable length of the name- Returns:
- the symbol name.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - value is null.
-
H5Tenum_nameof
public static int H5Tenum_nameof(int type, int[] value, java.lang.String[] name, int size) throws HDF5LibraryException, java.lang.NullPointerException
H5Tenum_nameof finds the symbol name that corresponds to the specified value of the enumeration datatype type.- Parameters:
type
- IN: Identifier of datatype.value
- IN: The value of the member, data of the correctname
- OUT: The name of the membersize
- IN: The max length of the name- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Tenum_valueof
public static void H5Tenum_valueof(int type, java.lang.String name, byte[] value) throws HDF5LibraryException, java.lang.NullPointerException
H5Tenum_valueof finds the value that corresponds to the specified name of the enumeration datatype type.- Parameters:
type
- IN: Identifier of datatype.name
- IN: The name of the membervalue
- OUT: The value of the member- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
-
H5Tenum_valueof
public static int H5Tenum_valueof(int type, java.lang.String name, int[] value) throws HDF5LibraryException, java.lang.NullPointerException
H5Tenum_valueof finds the value that corresponds to the specified name of the enumeration datatype type.- Parameters:
type
- IN: Identifier of datatype.name
- IN: The name of the membervalue
- OUT: The value of the member- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Tequal
public static boolean H5Tequal(int type_id1, int type_id2) throws HDF5LibraryException
H5Tequal determines whether two datatype identifiers refer to the same datatype.- Parameters:
type_id1
- IN: Identifier of datatype to compare.type_id2
- IN: Identifier of datatype to compare.- Returns:
- true if the datatype identifiers refer to the same datatype, else false.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_array_dims
@Deprecated public static int H5Tget_array_dims(int type_id, int[] dims, int[] perm) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8H5Tget_array_dims returns the sizes of the dimensions of the specified array datatype object.- Parameters:
type_id
- IN: Datatype identifier of array object.dims
- OUT: Sizes of array dimensions.perm
- OUT: Dimension permutations. (This parameter is not used.)- Returns:
- the non-negative number of dimensions of the array type
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - dims is null.
-
H5Tget_array_dims
@Deprecated public static int H5Tget_array_dims(int type_id, long[] dims, int[] perm) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Tget_array_dims(int, long[])
H5Tget_array_dims returns the sizes of the dimensions of the specified array datatype object.- Parameters:
type_id
- IN: Datatype identifier of array object.dims
- OUT: Sizes of array dimensions.perm
- OUT: Dimension permutation. (Currently not implemented.)- Returns:
- the non-negative number of dimensions of the array type
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
-
H5Tget_array_dims
public static int H5Tget_array_dims(int type_id, long[] dims) throws HDF5LibraryException, java.lang.NullPointerException
H5Tget_array_dims returns the sizes of the dimensions of the specified array datatype object.- Parameters:
type_id
- IN: Datatype identifier of array object.dims
- OUT: Sizes of array dimensions.- Returns:
- the non-negative number of dimensions of the array type
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - dims is null.
-
H5Tget_array_dims2
public static int H5Tget_array_dims2(int type_id, long[] dims) throws HDF5LibraryException, java.lang.NullPointerException
H5Tget_array_dims2 returns the sizes of the dimensions of the specified array datatype object.- Parameters:
type_id
- IN: Datatype identifier of array object.dims
- OUT: Sizes of array dimensions.- Returns:
- the non-negative number of dimensions of the array type
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - dims is null.- See Also:
H5Tget_array_dims(int, int[], int[])
-
H5Tget_array_ndims
public static int H5Tget_array_ndims(int type_id) throws HDF5LibraryException
H5Tget_array_ndims returns the rank, the number of dimensions, of an array datatype object.- Parameters:
type_id
- IN: Datatype identifier of array object.- Returns:
- the rank of the array
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_class
public static int H5Tget_class(int type_id) throws HDF5LibraryException
H5Tget_class returns the datatype class identifier.- Parameters:
type_id
- IN: Identifier of datatype to query.- Returns:
- datatype class identifier if successful; otherwise H5T_NO_CLASS(-1).
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_class_name
public static java.lang.String H5Tget_class_name(int class_id)
H5Tget_class_name returns the datatype class identifier.- Parameters:
class_id
- IN: Identifier of class from H5Tget_class.- Returns:
- class name if successful; otherwise H5T_NO_CLASS.
-
H5Tget_create_plist
public static int H5Tget_create_plist(int type_id) throws HDF5LibraryException
H5Tget_create_plist returns a property list identifier for the datatype creation property list associated with the datatype specified by type_id.- Parameters:
type_id
- IN: Identifier of datatype.- Returns:
- a datatype property list identifier.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_cset
public static int H5Tget_cset(int type_id) throws HDF5LibraryException
H5Tget_cset retrieves the character set type of a string datatype.- Parameters:
type_id
- IN: Identifier of datatype to query.- Returns:
- a valid character set type if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_cset
public static int H5Tset_cset(int type_id, int cset) throws HDF5LibraryException
H5Tset_cset the character set to be used.- Parameters:
type_id
- IN: Identifier of datatype to modify.cset
- IN: Character set type.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_ebias
public static int H5Tget_ebias(int type_id) throws HDF5LibraryException
H5Tget_ebias retrieves the exponent bias of a floating-point type.- Parameters:
type_id
- Identifier of datatype to query.- Returns:
- the bias if successful; otherwise 0.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_ebias
public static int H5Tset_ebias(int type_id, int ebias) throws HDF5LibraryException
H5Tset_ebias sets the exponent bias of a floating-point type.- Parameters:
type_id
- Identifier of datatype to set.ebias
- Exponent bias value.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_ebias_long
public static long H5Tget_ebias_long(int type_id) throws HDF5LibraryException
H5Tget_ebias retrieves the exponent bias of a floating-point type.- Parameters:
type_id
- IN: Identifier of datatype to query.- Returns:
- the bias
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_ebias
public static void H5Tset_ebias(int type_id, long ebias) throws HDF5LibraryException
H5Tset_ebias sets the exponent bias of a floating-point type.- Parameters:
type_id
- IN: Identifier of datatype to set.ebias
- IN: Exponent bias value.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_fields
public static void H5Tget_fields(int type_id, long[] fields) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
H5Tget_fields retrieves information about the locations of the various bit fields of a floating point datatype.- Parameters:
type_id
- IN: Identifier of datatype to query.fields
- OUT: location of size and bit-position.- fields[0] = spos OUT: location to return size of in bits.
- fields[1] = epos OUT: location to return exponent bit-position.
- fields[2] = esize OUT: location to return size of exponent in bits.
- fields[3] = mpos OUT: location to return mantissa bit-position.
- fields[4] = msize OUT: location to return size of mantissa in bits.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - fields is null.java.lang.IllegalArgumentException
- - fields array is invalid.
-
H5Tget_fields
public static int H5Tget_fields(int type_id, int[] fields) throws HDF5LibraryException, java.lang.NullPointerException, java.lang.IllegalArgumentException
H5Tget_fields retrieves information about the locations of the various bit fields of a floating point datatype.- Parameters:
type_id
- IN: Identifier of datatype to query.fields
- OUT: location of size and bit-position.fields[0] = spos OUT: location to return size of in bits. fields[1] = epos OUT: location to return exponent bit-position. fields[2] = esize OUT: location to return size of exponent in bits. fields[3] = mpos OUT: location to return mantissa bit-position. fields[4] = msize OUT: location to return size of mantissa in bits.
- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - fields is null.java.lang.IllegalArgumentException
- - fields array is invalid.
-
H5Tset_fields
public static void H5Tset_fields(int type_id, long spos, long epos, long esize, long mpos, long msize) throws HDF5LibraryException
H5Tset_fields sets the locations and sizes of the various floating point bit fields.- Parameters:
type_id
- IN: Identifier of datatype to set.spos
- IN: Size position.epos
- IN: Exponent bit position.esize
- IN: Size of exponent in bits.mpos
- IN: Mantissa bit position.msize
- IN: Size of mantissa in bits.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_fields
public static int H5Tset_fields(int type_id, int spos, int epos, int esize, int mpos, int msize) throws HDF5LibraryException
H5Tset_fields sets the locations and sizes of the various floating point bit fields.- Parameters:
type_id
- Identifier of datatype to set.spos
- Size position.epos
- Exponent bit position.esize
- Size of exponent in bits.mpos
- Mantissa bit position.msize
- Size of mantissa in bits.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_inpad
public static int H5Tget_inpad(int type_id) throws HDF5LibraryException
H5Tget_inpad retrieves the internal padding type for unused bits in floating-point datatypes.- Parameters:
type_id
- IN: Identifier of datatype to query.- Returns:
- a valid padding type if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_inpad
public static int H5Tset_inpad(int type_id, int inpad) throws HDF5LibraryException
If any internal bits of a floating point type are unused (that is, those significant bits which are not part of the sign, exponent, or mantissa), then H5Tset_inpad will be filled according to the value of the padding value property inpad.- Parameters:
type_id
- IN: Identifier of datatype to modify.inpad
- IN: Padding type.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_member_class
public static int H5Tget_member_class(int type_id, int membno) throws HDF5LibraryException
H5Tget_member_class returns the class of datatype of the specified member.- Parameters:
type_id
- IN: Datatype identifier of compound object.membno
- IN: Compound object member number.- Returns:
- the class of the datatype of the field if successful;
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_member_index
public static int H5Tget_member_index(int type_id, java.lang.String field_name)
H5Tget_member_index retrieves the index of a field of a compound datatype.- Parameters:
type_id
- IN: Identifier of datatype to query.field_name
- IN: Field name of the field index to retrieve.- Returns:
- if field is defined, the index; else negative.
-
H5Tget_member_name
public static java.lang.String H5Tget_member_name(int type_id, int field_idx)
H5Tget_member_name retrieves the name of a field of a compound datatype or an element of an enumeration datatype.- Parameters:
type_id
- IN: Identifier of datatype to query.field_idx
- IN: Field index (0-based) of the field name to retrieve.- Returns:
- a valid pointer to the name if successful; otherwise null.
-
H5Tget_member_offset
public static long H5Tget_member_offset(int type_id, int membno) throws HDF5LibraryException
H5Tget_member_offset returns the byte offset of the specified member of the compound datatype. This is the byte offset in the HDF-5 file/library, NOT the offset of any Java object which might be mapped to this data item.- Parameters:
type_id
- IN: Identifier of datatype to query.membno
- IN: Field index (0-based) of the field type to retrieve.- Returns:
- the offset of the member.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_member_type
public static int H5Tget_member_type(int type_id, int field_idx) throws HDF5LibraryException
H5Tget_member_type returns the datatype of the specified member.- Parameters:
type_id
- IN: Identifier of datatype to query.field_idx
- IN: Field index (0-based) of the field type to retrieve.- Returns:
- the identifier of a copy of the datatype of the field if successful;
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_member_value
public static void H5Tget_member_value(int type_id, int membno, byte[] value) throws HDF5LibraryException, java.lang.NullPointerException
H5Tget_member_value returns the value of the enumeration datatype member memb_no.- Parameters:
type_id
- IN: Datatype identifier for the enumeration datatype.membno
- IN: Number of the enumeration datatype member.value
- OUT: The value of the member- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - value is null.
-
H5Tget_member_value
public static int H5Tget_member_value(int type_id, int membno, int[] value) throws HDF5LibraryException, java.lang.NullPointerException
H5Tget_member_value returns the value of the enumeration datatype member memb_no.- Parameters:
type_id
- IN: Identifier of datatype.membno
- IN: The name of the membervalue
- OUT: The value of the member- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - value is null.
-
H5Tget_native_type
public static int H5Tget_native_type(int type_id) throws HDF5LibraryException
H5Tget_native_type returns the equivalent native datatype for the datatype specified in type_id.- Parameters:
type_id
- IN: Identifier of datatype to query. Direction of search is assumed to be in ascending order.- Returns:
- the native datatype identifier for the specified dataset datatype.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_native_type
public static int H5Tget_native_type(int type_id, int direction) throws HDF5LibraryException
H5Tget_native_type returns the equivalent native datatype for the datatype specified in type_id.- Parameters:
type_id
- IN: Identifier of datatype to query.direction
- IN: Direction of search.- Returns:
- the native datatype identifier for the specified dataset datatype.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_nmembers
public static int H5Tget_nmembers(int type_id) throws HDF5LibraryException
H5Tget_nmembers retrieves the number of fields a compound datatype has.- Parameters:
type_id
- IN: Identifier of datatype to query.- Returns:
- number of members datatype has if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_norm
public static int H5Tget_norm(int type_id) throws HDF5LibraryException
H5Tget_norm retrieves the mantissa normalization of a floating-point datatype.- Parameters:
type_id
- IN: Identifier of datatype to query.- Returns:
- a valid normalization type if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_norm
public static int H5Tset_norm(int type_id, int norm) throws HDF5LibraryException
H5Tset_norm sets the mantissa normalization of a floating-point datatype.- Parameters:
type_id
- IN: Identifier of datatype to set.norm
- IN: Mantissa normalization type.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_offset
public static int H5Tget_offset(int type_id) throws HDF5LibraryException
H5Tget_offset retrieves the bit offset of the first significant bit.- Parameters:
type_id
- IN: Identifier of datatype to query.- Returns:
- a positive offset value if successful; otherwise 0.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_offset
public static int H5Tset_offset(int type_id, int offset) throws HDF5LibraryException
H5Tset_offset sets the bit offset of the first significant bit.- Parameters:
type_id
- Identifier of datatype to set.offset
- Offset of first significant bit.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_offset
public static void H5Tset_offset(int type_id, long offset) throws HDF5LibraryException
H5Tset_offset sets the bit offset of the first significant bit.- Parameters:
type_id
- IN: Identifier of datatype to set.offset
- IN: Offset of first significant bit.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_order
public static int H5Tget_order(int type_id) throws HDF5LibraryException
H5Tget_order returns the byte order of an atomic datatype.- Parameters:
type_id
- IN: Identifier of datatype to query.- Returns:
- a byte order constant if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_order
public static int H5Tset_order(int type_id, int order) throws HDF5LibraryException
H5Tset_order sets the byte ordering of an atomic datatype.- Parameters:
type_id
- IN: Identifier of datatype to set.order
- IN: Byte ordering constant.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_pad
public static int H5Tget_pad(int type_id, int[] pad) throws HDF5LibraryException, java.lang.NullPointerException
H5Tget_pad retrieves the padding type of the least and most-significant bit padding.- Parameters:
type_id
- IN: Identifier of datatype to query.pad
- OUT: locations to return least-significant and most-significant bit padding type.pad[0] = lsb // least-significant bit padding type pad[1] = msb // most-significant bit padding type
- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - pad is null.
-
H5Tset_pad
public static int H5Tset_pad(int type_id, int lsb, int msb) throws HDF5LibraryException
H5Tset_pad sets the least and most-significant bits padding types.- Parameters:
type_id
- IN: Identifier of datatype to set.lsb
- IN: Padding type for least-significant bits.msb
- IN: Padding type for most-significant bits.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_precision
public static int H5Tget_precision(int type_id) throws HDF5LibraryException
H5Tget_precision returns the precision of an atomic datatype.- Parameters:
type_id
- Identifier of datatype to query.- Returns:
- the number of significant bits if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_precision
public static int H5Tset_precision(int type_id, int precision) throws HDF5LibraryException
H5Tset_precision sets the precision of an atomic datatype.- Parameters:
type_id
- Identifier of datatype to set.precision
- Number of bits of precision for datatype.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_precision_long
public static long H5Tget_precision_long(int type_id) throws HDF5LibraryException
H5Tget_precision returns the precision of an atomic datatype.- Parameters:
type_id
- IN: Identifier of datatype to query.- Returns:
- the number of significant bits if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_precision
public static void H5Tset_precision(int type_id, long precision) throws HDF5LibraryException
H5Tset_precision sets the precision of an atomic datatype.- Parameters:
type_id
- IN: Identifier of datatype to set.precision
- IN: Number of bits of precision for datatype.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_sign
public static int H5Tget_sign(int type_id) throws HDF5LibraryException
H5Tget_sign retrieves the sign type for an integer type.- Parameters:
type_id
- IN: Identifier of datatype to query.- Returns:
- a valid sign type if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_sign
public static int H5Tset_sign(int type_id, int sign) throws HDF5LibraryException
H5Tset_sign sets the sign proprety for an integer type.- Parameters:
type_id
- IN: Identifier of datatype to set.sign
- IN: Sign type.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_size
public static int H5Tget_size(int type_id) throws HDF5LibraryException
H5Tget_size returns the size of a datatype in bytes.- Parameters:
type_id
- Identifier of datatype to query.- Returns:
- the size of the datatype in bytes if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_size
public static int H5Tset_size(int type_id, int size) throws HDF5LibraryException
H5Tset_size sets the total size in bytes, size, for an atomic datatype (this operation is not permitted on compound datatypes).- Parameters:
type_id
- Identifier of datatype to change size.size
- Size in bytes to modify datatype.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_size_long
public static long H5Tget_size_long(int type_id) throws HDF5LibraryException
H5Tget_size returns the size of a datatype in bytes.- Parameters:
type_id
- IN: Identifier of datatype to query.- Returns:
- the size of the datatype in bytes
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_size
public static void H5Tset_size(int type_id, long size) throws HDF5LibraryException
H5Tset_size sets the total size in bytes, size, for an atomic datatype (this operation is not permitted on compound datatypes).- Parameters:
type_id
- IN: Identifier of datatype to change size.size
- IN: Size in bytes to modify datatype.- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_strpad
public static int H5Tget_strpad(int type_id) throws HDF5LibraryException
H5Tget_strpad retrieves the string padding method for a string datatype.- Parameters:
type_id
- IN: Identifier of datatype to query.- Returns:
- a valid string padding type if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_strpad
public static int H5Tset_strpad(int type_id, int strpad) throws HDF5LibraryException
H5Tset_strpad defines the storage mechanism for the string.- Parameters:
type_id
- IN: Identifier of datatype to modify.strpad
- IN: String padding type.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_super
public static int H5Tget_super(int type) throws HDF5LibraryException
H5Tget_super returns the type from which TYPE is derived.- Parameters:
type
- IN: Identifier of datatype.- Returns:
- the parent type
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tget_tag
public static java.lang.String H5Tget_tag(int type) throws HDF5LibraryException
H5Tget_tag returns the tag associated with datatype type_id.- Parameters:
type
- IN: Identifier of datatype.- Returns:
- the tag
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tset_tag
public static int H5Tset_tag(int type, java.lang.String tag) throws HDF5LibraryException
H5Tset_tag tags an opaque datatype type_id with a unique ASCII identifier tag.- Parameters:
type
- IN: Datatype identifier for the opaque datatype to be tagged.tag
- IN: Descriptive ASCII string with which the opaque datatype is to be tagged.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tinsert
public static int H5Tinsert(int type_id, java.lang.String name, long offset, int field_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Tinsert adds another member to the compound datatype type_id.- Parameters:
type_id
- IN: Identifier of compound datatype to modify.name
- IN: Name of the field to insert.offset
- IN: Offset in memory structure of the field to insert.field_id
- IN: Datatype identifier of the field to insert.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Tis_variable_str
public static boolean H5Tis_variable_str(int type_id) throws HDF5LibraryException
H5Tis_variable_str determines whether the datatype identified in type_id is a variable-length string.- Parameters:
type_id
- IN: Identifier of datatype to query.- Returns:
- true if type_id is a variable-length string.
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tlock
public static int H5Tlock(int type_id) throws HDF5LibraryException
H5Tlock locks the datatype specified by the type_id identifier, making it read-only and non-destrucible.- Parameters:
type_id
- IN: Identifier of datatype to lock.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Topen
@Deprecated public static int H5Topen(int loc_id, java.lang.String name) throws HDF5LibraryException, java.lang.NullPointerException
Deprecated.As of HDF5 1.8, replaced byH5Topen(int, String, int)
H5Topen opens a named datatype at the location specified by loc_id and return an identifier for the datatype.- Parameters:
loc_id
- IN: A file, group, or datatype identifier.name
- IN: A datatype name, defined within the file or group identified by loc_id.- Returns:
- a named datatype identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Topen
public static int H5Topen(int loc_id, java.lang.String name, int tapl_id) throws HDF5LibraryException, java.lang.NullPointerException
H5Topen opens a named datatype at the location specified by loc_id and return an identifier for the datatype.- Parameters:
loc_id
- IN: A file, group, or datatype identifier.name
- IN: A datatype name, defined within the file or group identified by loc_id.tapl_id
- IN: Datatype access property list.- Returns:
- a named datatype identifier if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.java.lang.NullPointerException
- - name is null.
-
H5Tpack
public static int H5Tpack(int type_id) throws HDF5LibraryException
H5Tpack recursively removes padding from within a compound datatype to make it more efficient (space-wise) to store that data.WARNING: This call only affects the C-data, even if it succeeds, there may be no visible effect on Java objects.
- Parameters:
type_id
- IN: Identifier of datatype to modify.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Tvlen_create
public static int H5Tvlen_create(int base_id) throws HDF5LibraryException
H5Tvlen_create creates a new variable-length (VL) dataype.- Parameters:
base_id
- IN: Identifier of parent datatype.- Returns:
- a non-negative value if successful
- Throws:
HDF5LibraryException
- - Error from the HDF-5 Library.
-
H5Zfilter_avail
public static int H5Zfilter_avail(int filter) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
H5Zget_filter_info
public static int H5Zget_filter_info(int filter) throws HDF5LibraryException
- Throws:
HDF5LibraryException
-
H5Zunregister
public static int H5Zunregister(int filter) throws HDF5LibraryException, java.lang.NullPointerException
- Throws:
HDF5LibraryException
java.lang.NullPointerException
-
-