.. algorithm::

.. summary::

.. relatedalgorithms::

.. properties::

Description
-----------

This algorithm loads an ARIEL-style 5-column ASCII ``.cal`` file into up to
3 workspaces: a GroupingWorkspace, OffsetsWorkspace and/or MaskWorkspace.

The format is described :ref:`here <CalFile>`.

Usage
-----

.. include:: ../usagedata-note.txt

The following provides a simple example that uses just the instrument geometry to
create the necessary workspaces.

.. testcode:: ExInstrumentBase

    # Grouping, offsets and masking workspaces are all made by default.
    # WorkspaceName parameter is required in spite of docs not saying so.
    ws = LoadCalFile(InstrumentName="GEM", CalFilename="offsets_2006_cycle064.cal",
                     WorkspaceName="ws")
    print("Total number of workspaces = {}".format(len(ws)))
    print("Workspace 1 type = {}".format(ws[0].id()))
    print("Workspace 2 type = {}".format(ws[1].id()))
    print("Workspace 3 type = {}".format(ws[2].id()))
    print("Workspace 4 type = {}".format(ws[3].id()))

Output:

.. testoutput:: ExInstrumentBase

    Total number of workspaces = 4
    Workspace 1 type = GroupingWorkspace
    Workspace 2 type = OffsetsWorkspace
    Workspace 3 type = MaskWorkspace
    Workspace 4 type = TableWorkspace

.. categories::

.. sourcelink::