.. _events fusion:

Events Fusion
=============

.. container:: lang-en

   Joins the secondary events of each *spot* (e.g. field observations of a
   plot) with the primary events (e.g. the weather series of its station) and
   stacks all spots into one table with the ``SPOT_ID`` column. It replaces
   the ``events-spec-<EID>.txt`` file and ``buildEventTables`` of the original
   R code.

   **Inputs**

   - **Primary Events** (several tables): high-frequency series (e.g. one
     table per weather station). Each table is a station identified by the
     table name (the file name), unless a *station column* is chosen.
   - **Secondary Events** (several tables): low-frequency series with the
     variable to predict (e.g. one table per plot). Each table is a spot,
     unless a *spot column* is chosen (a single table with all plots).
   - **Spot-Station Mapping** (optional): a two-column table (spot, station)
     for automatic assignment.

   **Output — Events**: one table with ``SPOT_ID`` (meta), ``TIME`` (time
   variable) and all the variables of both kinds of events. As in R
   (``bio_events[wea_events]``) the primary events define the timeline: all
   their rows are kept (secondary variables are missing where there is no
   observation) and secondary rows whose instant does not exist in the primary
   series are dropped, unless *outer join* is ticked.

   **Options**

   - *Time column*: ``TIME`` by default. If it was read as text (e.g.
     ``01/01/2022 0:00``) give its format (``%d/%m/%Y %H:%M``). A column with
     only the year is taken as December 31.
   - *Spot → station assignment*: for each detected spot choose the station.
     With a single station it is assigned to all; it can also be taken from a
     column of the secondary events or from the mapping table. A spot without
     station is sent with its secondary events only (the ``*`` of the R events
     file).
   - *Treat discrete variables with numeric values as numeric*: Orange turns
     numeric columns with few values into discrete ones; R treats them as
     numeric. Keep it ticked to reproduce R.

.. container:: lang-es

   Une los eventos secundarios de cada *spot* (por ejemplo, observaciones de
   campo de una parcela) con los eventos primarios (por ejemplo, la serie
   meteorológica de la estación que le corresponde) y apila todos los spots
   en una única tabla con la columna ``SPOT_ID``. Sustituye al fichero
   ``events-spec-<EID>.txt`` y a ``buildEventTables`` del código R original.

   **Entradas**

   - **Primary Events** (varias tablas): series de alta frecuencia (p. ej.
     una tabla por estación meteorológica). Cada tabla es una estación cuyo
     identificador es el nombre de la tabla (el del fichero), salvo que se
     indique una *columna de estación*.
   - **Secondary Events** (varias tablas): series de baja frecuencia con la
     variable a predecir (p. ej. una tabla por parcela). Cada tabla es un
     spot, salvo que se indique una *columna de spot* (una sola tabla con
     todas las parcelas).
   - **Spot-Station Mapping** (opcional): tabla con dos columnas (spot,
     estación) para asignar automáticamente.

   **Salida — Events**: una tabla con ``SPOT_ID`` (metadato), ``TIME``
   (variable temporal) y todas las variables de ambos tipos de eventos. Como
   en R (``bio_events[wea_events]``), la línea temporal la marcan los eventos
   primarios: se conservan todas sus filas (las variables secundarias quedan
   ausentes donde no hay observación) y se descartan las filas secundarias
   cuyo instante no exista en los primarios, salvo que se marque *unión
   externa*.

   **Opciones**

   - *Columna temporal*: por defecto ``TIME``. Si se ha leído como texto (p.
     ej. ``01/01/2022 0:00``) indique el formato (``%d/%m/%Y %H:%M``). Una
     columna con solo el año se interpreta como el 31 de diciembre.
   - *Asignación spot → estación*: para cada spot detectado se elige la
     estación. Si solo hay una estación se asigna a todos; también puede
     tomarse de una columna de los eventos secundarios o de la tabla de
     asignación. Un spot sin estación se emite solo con sus eventos
     secundarios (equivale al ``*`` del fichero de eventos de R).
   - *Tratar como numéricas las variables discretas con valores numéricos*:
     Orange convierte en discretas las columnas numéricas con pocos valores;
     R las trata como numéricas. Manténgalo marcado para reproducir R.
