Main Content

Multiport Selector

Distribute arbitrary subsets of input rows or columns to multiple output ports

  • Multiport Selector block

Libraries:
DSP System Toolbox / Signal Management / Indexing
DSP System Toolbox HDL Support / Signal Management

Description

The Multiport Selector block extracts multiple subsets of rows or columns from M-by-N input matrix u, and propagates each new submatrix to a distinct output port. For more details, see the description of the Select and Indices to output parameters.

Examples

expand all

Multichannel signals, represented by matrices in the Simulink® environment, are frequently used in signal processing models for efficiency and compactness. Though most of the signal processing blocks can process multichannel signals, you may need to access just one channel or a particular range of samples in a multichannel signal. You can access individual channels of the multichannel signal by using the blocks in the Indexing library. This library includes the Selector, Submatrix, Variable Selector, Multiport Selector, and Submatrix blocks.

You can split a multichannel based signal into single-channel signals using the Multiport Selector block. This block allows you to select specific rows and/or columns and propagate the selection to a chosen output port. In this example, a three-channel signal of size 3-by-1 is deconstructed into three independent signals of sample period 1 second.

Open the ex_splitmltichsbsigsind model.

Double-click the Signal From Workspace block, and set the block parameters as follows:

  • Signal = randn(3,1,10)

  • Sample time = 1

  • Samples per frame = 1

Based on these parameters, the Signal From Workspace block outputs a three-channel signal with a sample period of 1 second.

Save these parameters and close the dialog box by clicking OK.

Double-click the Multiport Selector block. Set the block parameters as follows, and then click OK:

  • Select = Rows

  • Indices to output = {1,2,3}

Based on these parameters, the Multiport Selector block extracts the rows of the input. The Indices to output parameter setting specifies that row 1 of the input should be reproduced at output 1, row 2 of the input should be reproduced at output 2, and row 3 of the input should be reproduced at output 3.

Run the model.

At the MATLAB® command line, type dsp_examples_yout. Because the input signal is random, your output might be different than the output shown here. This signal is the first row of the input to the Multiport Selector block. You can view the other two input rows by typing dsp_examples_yout1 and dsp_examples_yout2, respectively.

dsp_examples_yout(:,:,1) =

    0.8884


dsp_examples_yout(:,:,2) =

   -0.8095


dsp_examples_yout(:,:,3) =

    0.3252


dsp_examples_yout(:,:,4) =

   -1.7115


dsp_examples_yout(:,:,5) =

    0.3192


dsp_examples_yout(:,:,6) =

   -0.0301


dsp_examples_yout(:,:,7) =

    1.0933


dsp_examples_yout(:,:,8) =

    0.0774


dsp_examples_yout(:,:,9) =

   -0.0068


dsp_examples_yout(:,:,10) =

    0.3714


dsp_examples_yout(:,:,11) =

     0

You have now successfully created three single-channel signals from a multichannel signal using a Multiport Selector block.

Ports

Input

expand all

Specify the input u as a vector or a matrix of size M-by-N. The block treats an unoriented length-M vector input as an M-by-1 matrix.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean | fixed point | enumerated

Output

expand all

Row- or column-subsets of input, propagated to each output port. Each cell in the Indices to output array determines the subset of input rows or columns to be propagated to the respective output port. The total number of cells in the Indices to output array determines the number of output ports on the block.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean | fixed point | enumerated

Parameters

expand all

Select the input dimension as:

  • Rows –– The block uses the one-dimensional indices you specify to select matrix rows, and all elements on the chosen rows are included.

  • Columns –– The block uses the one-dimensional indices you specify to select matrix columns, and all elements on the chosen columns are included.

A given input row or column can appear any number of times in any of the outputs, or not at all.

When an index references a nonexistent row or column of the input, the block reacts with the action you specify using the Invalid index parameter.

Specify the row- or column-subsets to propagate to each of the output ports as a cell array. The kth cell contains a one-dimensional indexing expression specifying the subset of input rows or columns to be propagated to the kth output port. The total number of cells in the array determines the number of output ports on the block.

Consider the following Indices to output cell array. This is a four-cell array which requires the block to generate four independent outputs (each at a distinct port).

{4,[1:2 5],[7;8],10:-1:6}

The following table shows the dimensions of these outputs when Select = Rows and the input dimension is M-by-N.

CellExpressionDescriptionOutput Size

1

4

Row 4 of input

1-by-N

2

[1:2 5]

Rows 1, 2, and 5 of input

3-by-N

3

[7;8]

Rows 7 and 8 of input

2-by-N

4

10:-1:6

Rows 10, 9, 8, 7, and 6 of input

5-by-N

Specify the action to take when there is an invalid index value. You can select one of the following options:

  • Clip index — The block clips the index to the nearest valid value, and does not issue an alert.

    For example, if the block receives a 64-by-4 input and the Select parameter is set to Rows, the block clips an index of 72 to 64. For the same input, if the Select parameter is set to Columns, the block clips an index of 72 to 4. In both cases, the block clips an index of -2 to 1.

  • Clip and warn — The block clips the index to the nearest valid value and displays a warning message at the MATLAB® command line.

  • Generate error — The block displays an error dialog box and terminates the simulation.

Block Characteristics

Data Types

Boolean | double | enumerated | fixed point | integer | single

Direct Feedthrough

no

Multidimensional Signals

no

Variable-Size Signals

no

Zero-Crossing Detection

no

Extended Capabilities

Version History

Introduced before R2006a