Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5P_SET_BTREE_RATIOS

Sets B-tree split ratios for a dataset transfer property list

Procedure:

H5P_SET_BTREE_RATIOS ( plist, left, middle, right )

Signature:

herr_t H5Pset_btree_ratios(hid_t plist,
        double left,
        double middle,
        double right
    )
  

Fortran90 Interface: h5pset_btree_ratios_f
    
SUBROUTINE h5pset_btree_ratios_f(prp_id, left, middle, right, hdferr)
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: prp_id   
                                  ! Property list identifier
  REAL, INTENT(IN) :: left        ! The B-tree split ratio for left-most nodes
  REAL, INTENT(IN) :: middle      ! The B-tree split ratio for all other nodes
  REAL, INTENT(IN) :: right       ! The B-tree split ratio for right-most
                                  ! nodes and lone nodes.
  INTEGER, INTENT(OUT) :: hdferr  ! Error code
                                  ! 0 on success and -1 on failure
END SUBROUTINE h5pset_btree_ratios_f
	

Parameters:
hid_t plistIN: The dataset transfer property list identifier
double leftIN: The B-tree split ratio for left-most nodes
double rightIN: The B-tree split ratio for right-most nodes and lone nodes
double middle    IN: The B-tree split ratio for all other nodes

Description:

H5P_SET_BTREE_RATIOS sets the 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.

The ratio left is used when the splitting node is the left-most node at its level in the tree; the ratio right is used when the splitting node is the right-most node at its level; and the ratio middle is used for all other cases.

A node which is the only node at its level in the tree uses the ratio right when it splits.

All ratios are real numbers between 0 and 1, inclusive.

Returns:

Example:

Coming Soon!

History:

 

--- Last Modified: January 03, 2018 | 10:37 AM