Concatenate

Concatenates data from multiple sources.

Inputs

• Primary Data: data set that defines the attribute set
• Additional Data: additional data set

Outputs

• Data: concatenated data

The widget concatenates multiple sets of instances (data sets). The merge is "vertical", in a sense that two sets of 10 and 5 instances yield a new set of 15 instances.

1. Set the attribute merging method:

   • all variables that appear in input tables will output columns from all input tables, assinging missing values for columns that were absent in each table
   • only variables that appear in all tables will output an intersection of columns from all input tables

2. When merging multiple tables with the same data but different column names, check Use column names from the primary table and ignore names in other tables. The types of variables and names of categories (for categorical variables) must match.

   Check Treat variables with the same name as the same variable, even if they are computed using different formulae to consider columns with the same name as the same column in all input tables. Leaving it unchecked will not match by column name but by column identity.

3. Add the identification of source data sets to the output data set. The option will output an additional column with Feature name and a given type, defined in the Place option. The default will place source ID as a class variable. The new column will contain the names of the input tables as values.

4. If Apply automatically is ticked, changes are communicated automatically. Otherwise, click Apply.

If one of the tables is connected to the widget as the primary table, the resulting table will contain only the attributes from this table. If there is no primary table, the attributes can be either a union of all attributes that appear in the tables specified as Additional Tables, or their intersection, that is, a list of attributes common to all the connected tables.

Example

As shown below, the widget can be used for merging data from two separate files. Let's say we have two data sets with the same attributes, one containing instances from the first experiment and the other instances from the second experiment and we wish to join the two data tables together. We use the Concatenate widget to merge the data sets by attributes (appending new rows under existing attributes).

Below, we used a modified Zoo data set. In the first File widget, we loaded only the animals beginning with the letters A and B and in the second one only the animals beginning with the letter C. Upon concatenation, we observe the new data in the Data Table widget, where we see the complete table with animals from A to C.