STDF Reader 0.2.3
=================
|travis_|
|license|

.. |travis_| image:: https://travis-ci.org/cahoy/STDF_Reader.svg?branch=master
.. _travis: https://travis-ci.org/cahoy/STDF_Reader
.. |license| image:: https://img.shields.io/badge/license-MIT%20License-blue.svg

Read the binary STDF file (.std), which is the standard test data format
commonly used by Automated Test Equipment such as Teradyne, Advantest and
LTX testers. This library is meant to make reading such a file as easy as
reading a text file.

STDF References
***************
To utilize this library to its full extent, it is important to understand how
the structure of an STDF file is.

- `STDF V4 specification`_
- `STDF V4.2007 extension`_
- `STDF V4.2007 white paper`_
- `ATDF specification`_

.. _`STDF V4 specification`: http://casey.marshall.googlepages.com/stdfv4-spec.pdf
.. _`STDF V4.2007 extension`: https://www.google.com.sg/url?sa=t&rct=j&q=&esrc=s&source=web&cd=8&cad=rja&uact=8&ved=0ahUKEwi1w9m8r8TNAhXJPo8KHSmlB1YQFghQMAc&url=http%3A%2F%2Fdownloads.semi.org%2Fweb%2Fwstdsbal.nsf%2Fe48d2ee1db8c494688257635000362b3%2F9ccce41c84be829e882578e10081c3f1%2F%24FILE%2F4782C.doc&usg=AFQjCNGXlg9gdpNNuLf5k8Z9cFHVxrFG0g&sig2=mG5nzsjeftgslanxuEBgTw
.. _`STDF V4.2007 white paper`: http://ieeexplore.ieee.org/xpl/articleDetails.jsp?reload=true&arnumber=6252114
.. _`ATDF specification`: https://sourceforge.net/p/freestdf/svn/HEAD/tree/docs/atdf-spec.pdf?format=raw

Installation
************
Install the usual way.

::

    pip install stdf

Usage
*****
::

    from stdf import Reader
    std = Reader(stdf_file='input_file.std')

    for rec_name, header, body in std:
        if rec_name == 'FAR':
            # body is a dictionary with field name as keys.
            cpu_type = body['CPU_TYPE']

Documentation
*************
- Visit https://pythonhosted.org/stdf/

Limitation
**********
- STDF V4 format only.
- Python 3.3 and above.