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

« Previous Version 7 Current »

 

JAVA

FORTRAN

C++

C

 

Link

H5P_SET_VIRTUAL_VIEW

Sets the view of the virtual dataset (VDS) to include or exclude missing mapped elements

Procedure:

H5P_SET_VIRTUAL_VIEW ( dapl_id, view )

Signature:

herr_t H5Pset_virtual_view(
        hid_t dapl_id,
        H5D_vds_view_t view
        )
    

Fortran Interface: h5pset_virtual_view_f

Signature:
  SUBROUTINE h5pset_virtual_view_f(dapl_id, view, hdferr)
    INTEGER(HID_T), INTENT(IN)  :: dapl_id
    INTEGER       , INTENT(IN)  :: view
    INTEGER       , INTENT(OUT) :: hdferr

Inputs:
  dapl_id - Identifier of the virtual dataset access property list.
  view    - Flag specifying the extent of the data to be included in the view.
            Valid values are:
               H5D_VDS_FIRST_MISSING_F
               H5D_VDS_LAST_AVAILABLE_F

Outputs:
  hdferr   - Returns 0 if successful and -1 if fails.
        

Parameters:
hid_t dapl_idIN: Identifier of the virtual dataset access property list
H5D_vds_view_t view

IN: Flag specifying the extent of the data to be included in the view

Valid values are:

H5D_VDS_FIRST_MISSING  View includes all data before the first missing mapped data

H5D_VDS_LAST_AVAILABLE View includes all available mapped data

Description:

H5P_SET_VIRTUAL_VIEW takes the access property list for the virtual dataset, dapl_id, and the flag, view, and sets the VDS view according to the flag value.

If view is set to H5D_VDS_FIRST_MISSING, the view includes all data before the first missing mapped data. This setting provides a view containing only the continuous data starting with the dataset’s first data element. Any break in continuity terminates the view.

If view is set to H5D_VDS_LAST_AVAILABLE, the view includes all available mapped data.

Missing mapped data is filled with the fill value set in the VDS creation property list.

See Also:

 

Returns:

Returns a non-negative value if successful; otherwise returns a negative value.

Example:

        status = H5Pset_virtual_view (dapl, i ? H5D_VDS_LAST_AVAILABLE : H5D_VDS_FIRST_MISSING);
        vdset = H5Dopen2 (vfile, DATASET, dapl);

        /* Let's get space of the VDS and its dimension; we should get 32(or 20)x10x10 */
        vspace = H5Dget_space (vdset);
        H5Sget_simple_extent_dims (vspace, vdsdims_out, vdsdims_max_out);
        printf ("VDS dimensions, bounds = H5D_VDS_%s: ", i ? "LAST_AVAILABLE" : "FIRST_MISSING");
        for (j=0; j<RANK; j++)
            printf (" %d ", (int)vdsdims_out[j]);
        printf ("\n");

        /* Close */
        status = H5Dclose (vdset);
        status = H5Sclose (vspace);
    }

 

History:
Release    Change
1.10.0C function introduced with this release.

--- Last Modified: August 09, 2019 | 11:11 AM