HDF (.hdf)

  • Import and Export support the scientific dataset (SD) data model of the HDF format.

BackgroundBackground

    MIME type: application/x-hdf
    HDF data format Version 4.
    General-purpose format for representing multidimensional datasets.
    Used for storage, management, and exchange of scientific data.
    HDF is an acronym for Hierarchical Data Format.
    Developed by the U.S. National Center for Supercomputing Applications (NCSA).
    Binary file format.
    Incompatible with HDF Version 5.

Import and ExportImport and Export

  • Import["file.hdf"] imports an HDF file, returning the names of the datasets stored in the file.
  • Export["file.hdf",expr] exports a multidimensional array to an HDF file.
  • Import["file.hdf"] returns a list of strings representing the names of all datasets contained in the file.
  • Export["file.hdf",{expr1,},{"Datasets",{"/dataset1",}}] creates an HDF file, storing the arrays as separate datasets.
  • Import["file.hdf",elem] imports the specified element from an HDF file.
  • Import["file.hdf",{elem,suba,subb,}] imports a subelement.
  • Import["file.hdf",{{elem1,elem2,}}] imports multiple elements.
  • The import format can be specified with Import["file","HDF"] or Import["file",{"HDF",elem,}].
  • Export["file.hdf",expr,elem] creates an HDF file by treating expr as specifying element elem.
  • Export["file.hdf",{expr1,expr2,},{{elem1,elem2,}}] treats each as specifying the corresponding .
  • Export["file.hdf",expr,opt1->val1,] exports expr with the specified option elements taken to have the specified values.
  • Export["file.hdf",{elem1->expr1,elem2->expr2,},"Rules"] uses rules to specify the elements to be exported.
  • See the reference pages for full general information on Import and Export.
  • ImportString and ExportString support the HDF format.

ElementsElements

  • General Import elements:
  • "Elements"list of elements and options available in this file
    "Rules"full list of rules for each element and option
    "Options"list of rules for options, properties, and settings
  • Data representation elements:
  • "Data"all datasets imported as a list of arrays
    "Datasets"names of all datasets
  • Import by default uses the element for the HDF format.
  • Specifying and selecting datasets:
  • "Datasets",nn^(th) dataset
    "Datasets",datasetnamed dataset
  • Meta-information elements:
  • "DataFormat"type used to represent each dataset
    "Dimensions"data dimensions of each dataset
  • The following values can be given for :
  • "Integer8"8-bit integers
    "Integer16"16-bit integers
    "Integer32"32-bit integers
    "UnsignedInteger8"8-bit unsigned integers
    "UnsignedInteger16"16-bit unsigned integers
    "UnsignedInteger32"32-bit unsigned integers
    "Real32"IEEE single-precision numbers
    "Real64"IEEE double-precision numbers

OptionsOptions

  • Export option:
  • "Append"Falsewhether to append to an existing file

ExamplesExamplesopen allclose all

Basic Examples  (2)Basic Examples  (2)

Show the names of datasets in a file:

In[1]:=
Click for copyable input
Out[1]=

Import a dataset and render it as a raster image:

In[2]:=
Click for copyable input
In[3]:=
Click for copyable input
Out[3]=

Render as ArrayPlot, specifying a color scheme:

In[4]:=
Click for copyable input
Out[4]=

Rasterize the color image and export the data to HDF:

In[5]:=
Click for copyable input
Out[5]=

Create a random matrix and export it to HDF:

In[1]:=
Click for copyable input
Out[1]=
In[2]:=
Click for copyable input
Out[2]=

Show the datasets contained in the generated file:

In[3]:=
Click for copyable input
Out[3]=

Import the data:

In[4]:=
Click for copyable input
Out[4]=
Introduced in 2004
(5.1)
| Updated in 2007
(6.0)