Routines (alphabetical) > Routines: H > HDF Routines > HDF_SD_DIMGET

# HDF_SD_DIMGET

The HDF_SD_DIMGET procedure retrieves information about an SD dataset dimension.

## Examples

For an example using this routine, see the example for HDF_SD_DIMSET.

## Syntax

HDF_SD_DIMGET, Dim_ID [, /COUNT] [, COMPATIBILITY=variable] [, /FORMAT] [, /LABEL] [, /NAME] [, /NATTR] [, /SCALE] [, /TYPE] [, /UNIT]

## Arguments

### Dim_ID

A dimension ID as returned by HDF_SD _DIMGETID.

## Keywords

### COUNT

Set this keyword to return the dimension size.

### COMPATIBILITY

Set this keyword to a named variable that will contain a string indicating the dimensional compatibility of the current dimension. Possible values are “BW_COMP” (backwards compatible), “BW_INCOMP” (backwards incompatible), or “FAIL” (the information is unavailable). For further information about dimensional compatibilities, see the HDF User’s Guide, and the BW_INCOMP keyword of HDF_SD_DIMSET. By default, IDL writes HDF files in “BW_COMP” mode.

### FORMAT

Set this keyword to return the dimension format description string.

### LABEL

Set this keyword to return the dimension label description string.

### NAME

Set this keyword to return the dimension name.

### NATTR

Set this keyword to return the number of attributes for the dimension.

### SCALE

Set this keyword to return the scale of the dimension.

### TYPE

Set this keyword to return a string describing the data’s type (i.e., ‘BYTE’).

### UNIT

Set this keyword to return the dimension unit description string.

## Version History

4.0 | Introduced

## See Also

HDF_SD_CREATE, HDF_SD_DIMGETID, HDF_SD_DIMSET, HDF_SD_SELECT