.. highlight:: us

.. index:: @f{channelname}

.. _@f{channelname}:

@f{channelname}
===============

.. us.tag @f{channelname} English fieldfunction

The field function returns the channelname of the first dataset
in the diagram. The field function can be used in a text or table object
or in diagram axis title. The text or table object must be assigned 
to a diagram with datasets.

.. function::  @f{channelname}
    @f{channelname(ssAxis)}
    @f{channelname(ssAxis, ssType)}

.. us.params

**Parameters**

.. uparam:: ssAxis

   Specifies the channel. Valid values are "X", "Y" or "Z". Default value is "Y".
   Textdatei.

.. uparam:: ssType

   Specifies if the function should return the channel name or the channel
   name with the unit in brackets. Valid values are "name" or "name.unit".
   Default value is "name.unit".

.. us.example

**Example**

``@f{channelname(Y, name.unit)}``

**Output**:

   speed [1/min]

``@f{channelname(Y, name)}``

**Output**: 

   speed

``@f{channelname}`` 

**Output**: 

   speed [1/min]

.. seealso::
   :ref:`overview-field-functions`,
   :ref:`editupdate-fields`,
   :ref:`diagraminsert-field-function`

:sub:`id-122036`