sum

Suma de elementos del arreglo fi

Sintaxis

S = sum(A)

S = sum(A,dim)

S = sum(___,type)

Descripción

S = sum(A) devuelve la suma a lo largo de diferentes dimensiones del arreglo fi A.

• Si A es un vector, sum(A) devuelve la suma de los elementos.

• Si A es una matriz, sum(A) trata las columnas de A como vectores y devuelve un vector fila de las sumas de cada columna.

• Si A es un arreglo multidimensional, sum(A) trata los valores a lo largo de la primera dimensión no singleton como vectores y devuelve un arreglo de vectores fila.

S = sum(A,dim) suma a lo largo de la dimensión dim de A.

S = sum(___,type) devuelve un arreglo en la clase especificada por type.

Ejemplos

Suma de elementos de vector

Cree un vector fi y especifique propiedades fimath en el constructor.

A =  fi([1 2 5 8 5], 'SumMode', 'KeepLSB', 'SumWordLength', 32)

A = 
     1     2     5     8     5

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 11

        RoundingMethod: Nearest
        OverflowAction: Saturate
           ProductMode: FullPrecision
               SumMode: KeepLSB
         SumWordLength: 32
         CastBeforeSum: true

Calcule la suma de los elementos de A.

S = sum(A)

S = 
    21

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 32
        FractionLength: 11

        RoundingMethod: Nearest
        OverflowAction: Saturate
           ProductMode: FullPrecision
               SumMode: KeepLSB
         SumWordLength: 32
         CastBeforeSum: true

La salida S es un escalar con la propiedad SumWordLength especificada de 32. La propiedad FractionLength de S es 11 porque SumMode se estableció en KeepLSB.

Suma de elementos en cada columna

Cree un arreglo fi y calcule la suma de los elementos en cada columna.

A=fi([1 2 8;3 7 0;1 2 2])

A = 
     1     2     8
     3     7     0
     1     2     2

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 11

S=sum(A)

S = 
     5    11    10

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 18
        FractionLength: 11

MATLAB® devuelve un vector fila con las sumas de cada columna de A. La propiedad WordLength de S ha aumentado en dos bits porque ceil(log2(size(A,1)))=2. La propiedad FractionLength permanece igual porque la configuración predeterminada de SumMode es FullPrecision.

Suma de elementos en cada fila

Calcule la suma a lo largo de la segunda dimensión (dim=2) de la matriz de 3 por 3 A.

A=fi([1 2 8;3 7 0;1 2 2])

A = 
     1     2     8
     3     7     0
     1     2     2

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 11

S=sum(A, 2)

S = 
    11
    10
     5

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 18
        FractionLength: 11

MATLAB® devuelve un vector columna de las sumas de los elementos de cada fila. La propiedad WordLength de S es 18 porque ceil(log2(size(A,2)))=2.

Suma de elementos preservando el tipo de datos

Calcule las sumas de las columnas de A para que el arreglo de salida, S, tenga el mismo tipo de datos.

A = fi([1 2 8;3 7 0;1 2 2])

A = 
     1     2     8
     3     7     0
     1     2     2

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 11

class(A)

ans = 
'embedded.fi'

S = sum(A, 'native')

S = 
     5    11    10

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 18
        FractionLength: 11

class(S)

ans = 
'embedded.fi'

MATLAB® conserva el tipo de datos de A y devuelve un vector fila S de tipo embedded.fi.

Argumentos de entrada

A — Arreglo fi de entrada

Objeto fi | variable numérico

Arreglo fi de entrada, especificado como escalar, vector, matriz o arreglo multidimensional.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fi
Soporte de números complejos: Sí

dim — Dimensión sobre la que operar

escalar entero positivo

Dimensión sobre la que operar, especificada como un escalar entero positivo. dim también puede ser un objeto fi. Si no se especifica ningún valor, el valor predeterminado es la primera dimensión del arreglo cuyo tamaño no es igual a 1.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fi

type — Clase de salida

'double' | 'native'

Clase de salida, especificada como 'double' o 'native'. La clase de salida define el tipo de datos en el que se realiza y se devuelve la operación.

• Si type es 'double', entonces sum devuelve un arreglo de precisión doble, independientemente del tipo de datos de entrada.

• Si type es 'native', entonces sum devuelve un arreglo con la misma clase que el arreglo de entrada A.

Tipos de datos: char

Argumentos de salida

S — Arreglo de suma

escalar | vector | matriz | arreglo multidimensional

Arreglo de suma, devuelto como un escalar, un vector, una matriz o un arreglo multidimensional.

Nota

El objeto fimath se usa en el cálculo de la suma. Si SumMode se establece en FullPrecision, KeepLSB o KeepMSB, entonces el número de bits enteros de crecimiento para sum(A) es ceil(log2(size(A,dim))).

Limitaciones

• sum no admite objetos fi del tipo de datos Boolean.

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Indicaciones y limitaciones de uso:

• las entradas de tamaño variable solo se admiten cuando la propiedad SumMode del objeto fimath gobernante se establece en SpecifyPrecision o KeepLSB.

Generación de código HDL
Genere código VHDL, Verilog y SystemVerilog para diseños FPGA y ASIC mediante HDL Coder™.

Historial de versiones

Introducido antes de R2006a

Consulte también

sum | add | divide | fi | fimath | mpy | mrdivide | numerictype | rdivide | sub