.. _features description:

Features Description
====================

.. container:: lang-en

   Visual editor of the features description: the list of ``VF`` (*Versatile
   Function*) and ``OUT`` rows that says which statistics, of which variables
   and in which time windows will form the superdataset. It replaces the
   ``attributes-spec-<AID>.txt`` file of the R code; a file in that format
   read with **File** can be connected to the *Specification* input and
   imported.

   **Inputs**: **Events** (optional; provides the list of variables and
   validates the rows) and **Specification** (optional; table with the
   columns ``Attribute, Description, DeltaLag, Window, Param1..Param7``).

   **Output — Features Description**: table with the edited rows (connect it
   to **SuperDataset**).

   **VF rows**: each generates one feature per combination of *window* ×
   *size/scope* × *constraint* × *variable* × *function*, named
   ``<FUNC>_<VAR>[_C:<constraint><value>][_Delta<d>]_(<k|k+1>)W<window>_L<size>``.

   - *Windows*: ``-1`` is the interval ending at the reference instant, ``-2``
     the previous one, etc. (``-1:-2:-3``). Positive = future.
   - *Size / scope* (Param1): number of series units (days, hours or years
     depending on the frequency) or a keyword: ``FE`` (since the first event
     with output of the cycle), ``PREVCYCLE``, ``SPRING``, ``SUMMER``,
     ``AUTUMN``, ``WINTER``, ``PREVSUMMER``, ``PREVAUTUMN``, ``FCE/VAR/>/v``
     (since the first event of the cycle with VAR > v) or ``LC*/VAR/>/v``
     (since the last event with VAR > v).
   - *Variables* (Param2) and *functions* (Param3): ``AVG``, ``SUM``,
     ``MIN``, ``MAX``, ``SD``, ``COUNT``, ``FIRST``, ``LAST``. For non-numeric
     variables only ``COUNT``/``LAST``/``FIRST`` make sense.
   - *Constraint* (Param4/Param5): filters the events of the scope
     (``VAR.<``, ``VAR.>``, ``VAR.<>`` with values ``a_b``, ``VAR1.<>.VAR2``,
     ``VAR.LASTCHANGE``, ``VAR.LASTVALUE``). A ``COUNT`` of an empty scope is
     0 with a constraint and 1000000 without (R behaviour).
   - *Reference* (Param6): ``k`` = the current event; ``k+1`` = the future
     target event (``EventsPerAhead × Horizon`` rows later).
   - *DeltaLag*: with ``d > 1`` the slope of the variable with respect to the
     value ``d-1`` positions before is used.
   - *Param7 = 1*: disables the missing-value control (SuperDataset
     thresholds) for that row.

   **OUT rows** generate ``OUT_W<w>``: the value of the target ``w`` events
   with output before the current one (``0`` = the current one), provided
   they are closer than ``AheadTolerance × w`` units.

   **Buttons**: *Add as new row*, *Update row*, *Remove*, *Duplicate*,
   *Up/Down*, *Import from input*, *Basic template* (the GENERAL
   specification of the R code) and *Clear*. Table cells can also be edited
   directly. Rows with problems are shown in red with the explanation in the
   tooltip.

.. container:: lang-es

   Editor visual de la especificación de atributos: la lista de filas ``VF``
   (*Versatile Function*) y ``OUT`` que indica qué estadísticos, de qué
   variables y en qué ventanas temporales formarán el superdataset. Equivale
   al fichero ``attributes-spec-<AID>.txt`` del código R; un fichero de ese
   formato leído con **File** puede conectarse a la entrada *Specification* e
   importarse.

   **Entradas**: **Events** (opcional; ofrece la lista de variables y valida
   las filas) y **Specification** (opcional; tabla con las columnas
   ``Attribute, Description, DeltaLag, Window, Param1..Param7``).

   **Salida — Features Description**: tabla con las filas editadas (se
   conecta a **SuperDataset**).

   **Filas VF**: cada una genera un atributo por cada combinación de
   *ventana* × *tamaño/ámbito* × *restricción* × *variable* × *función*, con
   nombre
   ``<FUNC>_<VAR>[_C:<restricción><valor>][_Delta<d>]_(<k|k+1>)W<ventana>_L<tamaño>``.

   - *Ventanas*: ``-1`` es el intervalo que termina en el instante de
     referencia; ``-2`` el anterior, etc. (``-1:-2:-3``). Positivas = futuro.
   - *Tamaño / ámbito* (Param1): número de unidades del intervalo (días,
     horas o años según la frecuencia) o una palabra clave: ``FE`` (desde el
     primer evento con salida del ciclo), ``PREVCYCLE``, ``SPRING``,
     ``SUMMER``, ``AUTUMN``, ``WINTER``, ``PREVSUMMER``, ``PREVAUTUMN``,
     ``FCE/VAR/>/v`` (desde el primer evento del ciclo con VAR > v) o
     ``LC*/VAR/>/v`` (desde el último evento con VAR > v).
   - *Variables* (Param2) y *funciones* (Param3): ``AVG``, ``SUM``, ``MIN``,
     ``MAX``, ``SD``, ``COUNT``, ``FIRST``, ``LAST``. Para variables no
     numéricas solo tienen sentido ``COUNT``/``LAST``/``FIRST``.
   - *Restricción* (Param4/Param5): filtra los eventos del ámbito
     (``VAR.<``, ``VAR.>``, ``VAR.<>`` con valores ``a_b``, ``VAR1.<>.VAR2``,
     ``VAR.LASTCHANGE``, ``VAR.LASTVALUE``). Un ``COUNT`` de un ámbito vacío
     vale 0 si hay restricción y 1000000 si no la hay (comportamiento de R).
   - *Referencia* (Param6): ``k`` = el evento actual; ``k+1`` = el evento
     objetivo futuro (``EventsPerAhead × Horizonte`` filas después).
   - *DeltaLag*: con ``d > 1`` se calcula la pendiente de la variable
     respecto al valor ``d-1`` posiciones antes.
   - *Param7 = 1*: desactiva el control de valores ausentes (umbrales del
     widget SuperDataset) para esa fila.

   **Filas OUT**: generan ``OUT_W<w>``: el valor de la variable objetivo
   ``w`` eventos con salida antes del actual (``0`` = el actual), siempre que
   estén a menos de ``AheadTolerance × w`` unidades de distancia.

   **Botones**: *Añadir como nueva fila*, *Actualizar fila*, *Eliminar*,
   *Duplicar*, *Subir/Bajar*, *Importar de la entrada*, *Plantilla básica*
   (la especificación GENERAL del código R) y *Vaciar*. Las celdas de la
   tabla también se pueden editar directamente. Las filas con problemas se
   muestran en rojo con la explicación en el tooltip.
