.. highlightlang:: us

.. index:: Import of ATFX Files
.. index:: ATFX Files

.. _import-of-atfx-files:

Import of ATFX Files
====================

The Addin converts ATFX data files to UniPlot data files NC2.

.. note::
   The addin is a beta version. The release version is planned for end of 2014.

Used specification: ASAM CAT ODS Open Data Services V5.3.0, Part 6 of 16,
ATF/XML Version 1.3.0, Date: 31.12.2012, Base Standard, Association for
Standardization of Automation and Measuring Systems.

.. _installation_atfx:

Installation
------------

* Choose :ref:`tools-add-in-manager`.

* Check the "ATFX-Import" addin.

* Choose OK.

.. _usage_atfx:

Usage
-----

* Start UniPlot.

* Choose :ref:`fileimport-data`.

* Choose Type ``"ATFX File (*.atfx)"``.

* Select one or more ATFX files.

Programming
-----------

The source code can be found in IC files in the :file:`addin\\rs_atfx` directory.

API for reading::

   s = atfx_libversion()
   atfx = atfx_open(ssFile)
   oMeasurements = atfx_get_measurements(atfx)
   oSubmatrix = atfx_get_submatrices(atfx, oMeasurement)
   oLocalColumns = atfx_get_localcolumns(atfx, oSubMatrix)
   bool = atfx_close(atfx)

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - R2023.2
     - Loads all measurements at once and group channels by default. Behavior can
	   be changed in ``Tools => ATFX Configuration``.
   * - R2013.15
     - New.

:sub:`id-200202`