Scilab Home page | Wiki | Bug tracker | Forge | Mailing list archives | ATOMS | File exchange
Please login or create an account
Scilab 5.4.1
Change language to: Français - Português - 日本語 - Русский

Please note that the recommended version of Scilab is 6.0.2. This page might be outdated.
See the recommended documentation of this function

# union

extract union components of a vector

### Calling Sequence

```[v [,ka, kb] ] = union(a,b)
[v [,ka, kb] ] = union(a,b,orient)```

### Arguments

a

vector or matrix of numbers or strings

b

vector of real numbers or strings

orient

flag with possible values : 1 or "r", 2 or "c".

v

row vector or matrix of numbers or strings

ka

row vector of integers

kb

row vector of integers

### Description

`union(a,b)` returns a sorted row vector which retains the unique entries of `[a(:);b(:)]`.

`union(a,b,"r")` or `union(a,b,1)`returns the matrix formed by the union of the unique rows of `a` and `b` sorted in lexicographic ascending order. In this case matrices `a` and `b` must have the same number of columns.

`union(a,b,"c")` or `union(a,b,2)`returns the matrix formed by the union of the unique columns of `a` and `b` sorted in lexicographic ascending order. In this case matrices `a` and `b` must have the same number of rows.

`[v,ka,kb]=union(a,b)` also returns index vectors `ka` and `kb` such that `v` is a sorted combination of the entries `a(ka)` and `b(kb)`.

### Examples

```A=round(5*rand(10,1));
B=round(5*rand(7,1));

union(A,B)
[N,ka,kb]=union(A,B)

union('a'+string(A),'b'+string(B))```

### See Also

• unique — extract unique components of a vector or matrices
• gsort — sorting by quick sort algorithm

### Comments

Add a comment:
Please login to comment this page.

 Report an issue << setdiff Set operations unique >>

 Scilab EnterprisesCopyright (c) 2011-2017 (Scilab Enterprises)Copyright (c) 1989-2012 (INRIA)Copyright (c) 1989-2007 (ENPC)with contributors Last updated:Tue Apr 02 17:36:21 CEST 2013