.. index:: !MATLAB; code examples

.. TODO: needs a proper write-up using actual MATLAB session and graphics

.. _matlab.examples:

==============
HDF5 in MATLAB
==============

:author: Paul Kienzle, NIST

..	note:: **Editor's Note**:
	These files were copied directly from an older version 
	of the NeXus documentation (DocBook) and have not been checked
	that they will run under current Matlab versions.


``input.dat``
+++++++++++++

This is the same data used with :ref:`Example-Python`.

.. literalinclude:: input.dat
    :tab-width: 4
    :linenos:
    :language: text

writing data
++++++++++++

.. compound::

    .. rubric:: *basic_writer.m*: Write a NeXus HDF5 file using Matlab
    
    .. _Example-Matlab-BasicWriter:

    .. literalinclude:: basic_writer.m
	    :tab-width: 4
	    :linenos:
	    :language: text

reading data
++++++++++++

.. compound::

    .. rubric:: *basic_reader.m*: Read a NeXus HDF5 file using Matlab
    
    .. _Example-Matlab-BasicReader:

    .. literalinclude:: basic_reader.m
	    :tab-width: 4
	    :linenos:
	    :language: text


writing data file with links
++++++++++++++++++++++++++++

.. compound::

    .. rubric:: *writer_2_1.m*: Write a NeXus HDF5 file with links
    
    .. _Example-Matlab-Writer_2_1:

    .. literalinclude:: writer_2_1.m
	    :tab-width: 4
	    :linenos:
	    :language: text

.. compound::

    .. rubric:: *h5link.m*: support module for creating NeXus-style HDF5 hard links
    
    .. _Example-Matlab-h5link:

    .. literalinclude:: h5link.m
	    :tab-width: 4
	    :linenos:
	    :language: text


Downloads
+++++++++

========================== ============================================================
file                       description
========================== ============================================================
:download:`input.dat`      two-column text data file, also used in other examples
:download:`basic_writer.m` writes a NeXus HDF5 file using ``input.dat``
:download:`basic_reader.m` reads the NeXus HDF5 file written by ``basic_writer.m``
:download:`h5link.m`       support module for creating NeXus-style HDF5 hard links
:download:`writer_2_1.m`   like ``basic_writer.m`` but stores data in 
                           ``/entry/instrument/detector``
                           and then links to **NXdata** group
========================== ============================================================