Page tree

The license could not be verified: License Certificate has expired!

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

 

JAVA

FORTRAN

C++

C

 

Link

H5D_CREATE_ANON

Creates a dataset in a file without linking it into the file structure. 

Procedure:

H5D_CREATE_ANON(loc_id, type_id, space_id, dcpl_id, dapl_id)

Signature:

hid_t H5Dcreate_anonhid_t loc_idhid_t type_idhid_t space_idhid_t dcpl_idhid_t dapl_id ) 

SUBROUTINE h5dcreate_anon_f(loc_id, type_id, space_id, dset_id, hdferr, &
                            dcpl_id, dapl_id)
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN)  :: loc_id   ! File or group identifier. 
  INTEGER(HID_T), INTENT(IN)  :: type_id  ! Datatype identifier. 
  INTEGER(HID_T), INTENT(IN)  :: space_id ! Dataspace identifier.
  INTEGER(HID_T), INTENT(OUT) :: dset_id  ! Dataset identifier. 
  INTEGER, INTENT(OUT) :: hdferr          ! Error code.  
                                          ! 0 on success and -1 on failure
  INTEGER(HID_T), OPTIONAL, INTENT(IN) :: dcpl_id  
                                          ! Dataset creation property list 
                                          ! identifier.
  INTEGER(HID_T), OPTIONAL, INTENT(IN) :: dapl_id  
                                          ! Dataset access property list 
                                          ! identifier.
END SUBROUTINE h5dcreate_anon_f

Parameters:
hid_t loc_idIN: Identifier of the file or group within which to create the dataset.
hid_t type_idIN: Identifier of the datatype to use when creating the dataset.
hid_t space_id    IN: Identifier of the dataspace to use when creating the dataset.
hid_t dcpl_idIN: Dataset creation property list identifier.
hid_t dapl_idIN: Dataset access property list identifier.

Description:

H5Dcreate_anon creates a dataset in the file specified by loc_id.

loc_id may be a file identifier or a group identifier within that file.

The dataset’s datatype and dataspace are specified by type_id and space_id, respectively. These are the datatype and dataspace of the dataset as it will exist in the file, which may differ from the datatype and dataspace in application memory.

Dataset creation properties are specified in the dataset creation property list dcpl_id. Dataset access properties are specified in the dataset access property list dapl_id.

H5Dcreate_anon returns a new dataset identifier. Using this identifier, the new dataset must be linked into the HDF5 file structure with H5Olink or it will be deleted from the file when the file is closed.

See H5Dcreate for further details and considerations on the use of H5Dcreate and H5Dcreate_anon.

The differences between this function and H5Dcreate are as follows:

  • H5Dcreate_anon explicitly includes a dataset access property list. H5Dcreate always uses default dataset access properties.
  • H5Dcreate_anon neither provides the new dataset’s name nor links it into the HDF5 file structure; those actions must be performed separately through a call to H5Olink, which offers greater control over linking.

A dataset created with this function should be closed with H5Dclose when the dataset is no longer needed so that resource leaks will not develop.

Returns:

Returns a dataset identifier if successful; otherwise returns a negative value.

Example:

examples / h5_subset.c [32:42]  1.10/master  HDFFV/hdf5
int
main (void)
{
    hsize_t     dims[2], dimsm[2];   
    int         data[DIM0][DIM1];           /* data to write */
    int         sdata[DIM0_SUB][DIM1_SUB];  /* subset to write */
    int         rdata[DIM0][DIM1];          /* buffer for read */
 
    hid_t       file_id, dataset_id;        /* handles */
    hid_t       dataspace_id, memspace_id; 

     PROGRAM COMPOUNDEXAMPLE

     USE HDF5 ! This module contains all necessary modules

     IMPLICIT NONE

     CHARACTER(LEN=11), PARAMETER :: filename = "compound.h5" ! File name
     CHARACTER(LEN=8), PARAMETER :: dsetname = "Compound"     ! Dataset name
     INTEGER, PARAMETER :: dimsize = 6 ! Size of the dataset

     INTEGER(HID_T) :: file_id       ! File identifier

c++ / examples / create.cpp [33:43]  1.10/master  HDFFV/hdf5
int main (void)
{
   /*
    * Data initialization.
    */
   int i, j;
   int data[NX][NY];          // buffer for data to write
   for (j = 0; j < NX; j++)
   {
      for (i = 0; i < NY; i++)

public class H5Ex_D_Chunk {
    private static String FILENAME = "H5Ex_D_Chunk.h5";
    private static String DATASETNAME = "DS1";
    private static final int DIM_X = 6;
    private static final int DIM_Y = 8;
    private static final int CHUNK_X = 4;
    private static final int CHUNK_Y = 4;
    private static final int RANK = 2;
    private static final int NDIMS = 2;

History:
Release    C
1.8.0Function introduced in this release.

--- Last Modified: November 03, 2017 | 07:45 AM