numerictype

고정소수점 또는 부동소수점 데이터형을 나타내는 embedded.numerictype 객체 생성

구문

T = numerictype

T = numerictype(s)

T = numerictype(s,w)

T = numerictype(s,w,f)

T = numerictype(s,w,slope,bias)

T = numerictype(s,w,slopeadjustmentfactor,fixedexponent,bias)

T = numerictype(___,Name,Value)

T = numerictype(T1,Name,Value)

T = numerictype('Double')

T = numerictype('Single')

T = numerictype('Half')

T = numerictype('Boolean')

설명

T = numerictype은 디폴트 numerictype 객체를 만듭니다.

T = numerictype(s)는 스케일링이 지정되지 않고, 부호 속성값 s와 16비트 워드 길이를 갖는 고정소수점 numerictype 객체를 만듭니다.

T = numerictype(s,w)는 스케일링이 지정되지 않고, 부호 속성값 s와 워드 길이 w를 갖는 고정소수점 numerictype 객체를 만듭니다.

T = numerictype(s,w,f)는 이진 소수점 스케일링, 부호 속성값 s, 워드 길이 w 및 소수부 길이 f를 갖는 고정소수점 numerictype 객체를 만듭니다.

T = numerictype(s,w,slope,bias)는 기울기 및 편향 스케일링, 부호 속성값 s, 워드 길이 w, slope 및 bias를 갖는 고정소수점 numerictype 객체를 만듭니다.

T = numerictype(s,w,slopeadjustmentfactor,fixedexponent,bias)는 기울기 및 편향 스케일링, 부호 속성값 s, 워드 길이 w, slopeadjustmentfactor 및 bias를 갖는 고정소수점 numerictype 객체를 만듭니다.

T = numerictype(___,Name,Value)를 사용하면 이름-값 쌍을 사용하여 속성을 설정할 수 있습니다. 값을 지정하지 않은 속성에는 모두 디폴트 값이 할당됩니다.

T = numerictype(T1,Name,Value)를 사용하면 속성값의 일부 또는 전부를 수정하면서 기존 numerictype 객체 T의 복사본 T1을 만들 수 있습니다.

T = numerictype('Double')은 double형의 numerictype 객체를 만듭니다.

T = numerictype('Single')은 single형의 numerictype 객체를 만듭니다.

T = numerictype('Half')는 half형의 numerictype 객체를 만듭니다.

T = numerictype('Boolean')은 부울형의 numerictype 객체를 만듭니다.

예제

디폴트 numerictype 객체 만들기

이 예제에서는 디폴트 속성 설정을 사용하는 numerictype 객체를 만드는 방법을 보여줍니다.

T = numerictype

T =


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

디폴트 워드 길이 및 스케일링을 사용하는 numerictype 객체 만들기

이 예제에서는 워드 길이 w 및 소수부 길이 f에 대한 인수를 생략하여 디폴트 워드 길이 및 스케일링을 사용하는 numerictype 객체를 만드는 방법을 보여줍니다.

T = numerictype(1)

T =


          DataTypeMode: Fixed-point: unspecified scaling
            Signedness: Signed
            WordLength: 16

이 객체는 워드 길이가 16비트이고 스케일링을 지정하지 않은 부호 있는 객체입니다.

부호 인수 s를 사용하여 부호 없는 numerictype 객체를 만들 수 있습니다.

T = numerictype(0)

T =


          DataTypeMode: Fixed-point: unspecified scaling
            Signedness: Unsigned
            WordLength: 16

이 객체는 디폴트 워드 길이 16비트를 가지며 스케일링이 지정되지 않습니다.

스케일링을 지정하지 않은 numerictype 객체 만들기

이 예제에서는 소수부 길이 인수 f를 생략하여 스케일링을 지정하지 않은 numerictype 객체를 만드는 방법을 보여줍니다.

T = numerictype(1,32)

T =


          DataTypeMode: Fixed-point: unspecified scaling
            Signedness: Signed
            WordLength: 32

이 객체는 32비트 워드 길이를 갖는 부호 있는 객체입니다.

지정된 워드 길이와 소수부 길이를 갖는 numerictype 객체 만들기

이 예제에서는 이진 소수점 스케일링을 사용하고, 32비트 워드 길이 및 30비트 소수부 길이를 갖는 부호 있는 numerictype 객체를 만드는 방법을 보여줍니다.

T = numerictype(1,32,30)

T =


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

기울기 및 편향 스케일링을 사용하여 numerictype 객체 만들기

이 예제에서는 기울기 및 편향 스케일링을 사용하여 numerictype 객체를 만드는 방법을 보여줍니다. 기울기 및 편향 스케일링된 숫자의 실제 값은 다음과 같이 표현됩니다.

$$\mathrm{realworldvalue}=\left(\mathrm{slope}\times \mathrm{integer}\right)+\mathrm{bias}$$

워드 길이가 16비트, 기울기가 2^-2이고 편향이 4인 부호 있는 고정소수점 데이터형을 나타내는 numerictype 객체를 만듭니다.

T = numerictype(1,16,2^-2,4)

T =


          DataTypeMode: Fixed-point: slope and bias scaling
            Signedness: Signed
            WordLength: 16
                 Slope: 0.25
                  Bias: 4

또는 기울기는 다음과 같이 표현될 수 있습니다.

$$\mathrm{slope}=\mathrm{slopeadjustmentfactor}\times 2^{\mathrm{fixedexponent}}$$

워드 길이가 16비트, 기울기 조정 인자가 1, 고정 지수가 -2이고 편향이 4인 부호 있는 고정소수점 데이터형을 나타내는 numerictype 객체를 만듭니다.

T = numerictype(1,16,1,-2,4)

T =


          DataTypeMode: Fixed-point: slope and bias scaling
            Signedness: Signed
            WordLength: 16
                 Slope: 0.25
                  Bias: 4

지정된 속성값을 사용하여 numerictype 객체 만들기

이 예제에서는 객체 생성 시 이름-값 쌍을 사용하여 numerictype 속성을 설정하는 방법을 보여줍니다.

T = numerictype('Signed',true,...
    'DataTypeMode',...
    'Fixed-point: slope and bias scaling', ...
    'WordLength',32,...
    'Slope',2^-2,...
    'Bias',4)

T =


          DataTypeMode: Fixed-point: slope and bias scaling
            Signedness: Signed
            WordLength: 32
                 Slope: 0.25
                  Bias: 4

부호가 지정되지 않은 numerictype 객체 만들기

이 예제에서는 Signedness 속성을 Auto로 설정하기 위해 이름-값 쌍을 사용하여 부호가 지정되지 않은 numerictype 객체를 만드는 방법을 보여줍니다.

T = numerictype('Signedness','Auto')

T =


          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Auto
            WordLength: 16
        FractionLength: 15

지정된 데이터형을 갖는 numerictype 객체 만들기

이 예제에서는 인수와 이름-값 쌍을 사용하여 특정 데이터형을 갖는 numerictype 객체를 만드는 방법을 보여줍니다.

T = numerictype(0,24,12,'DataType','ScaledDouble')

T =


          DataTypeMode: Scaled double: binary point scaling
            Signedness: Unsigned
            WordLength: 24
        FractionLength: 12

반환된 numerictype 객체 T는 부호가 없으며 워드 길이가 24비트, 소수부 길이가 12비트이고 데이터형이 스케일링된 double형으로 설정되어 있습니다.

double형, single형, half형 또는 부울형 numerictype 객체 만들기

이 예제에서는 객체 생성 시 데이터형을 double형, single형, half형 또는 부울형으로 설정하여 numerictype 객체를 만드는 방법을 보여줍니다.

데이터형 모드를 double로 설정하여 numerictype 객체를 만듭니다.

T = numerictype('Double')

T =


          DataTypeMode: Double

데이터형 모드를 single로 설정하여 numerictype 객체를 만듭니다.

T = numerictype('Single')

T =


          DataTypeMode: Single

데이터형 모드를 half로 설정하여 numerictype 객체를 만듭니다.

T = numerictype('Half')

T =


          DataTypeMode: Half

데이터형 모드를 부울로 설정하여 numerictype 객체를 만듭니다.

T = numerictype('Boolean')

T =


          DataTypeMode: Boolean

입력 인수

s — 객체에 부호가 있는지 여부

true 또는 1 (디폴트 값) | false 또는 0

객체에 부호가 있는지 여부로, 숫자형이나 논리값 1(true) 또는 0(false)으로 지정됩니다.

예: T = numerictype(true)

데이터형: logical

w — 워드 길이

16 (디폴트 값) | 양의 정수

저장된 정수 값의 워드 길이(비트 수)로, 양의 정수로 지정됩니다.

예: T = numerictype(true,16)

데이터형: half | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

f — 소수부 길이

15 (디폴트 값) | 정수

저장된 정수 값의 소수부 길이(비트 수)로, 정수로 지정됩니다.

소수부 길이가 워드 길이보다 클 수 있습니다. 자세한 내용은 Binary Point Interpretation(Fixed-Point Designer) 항목을 참조하십시오.

예: T = numerictype(true,16,15)

데이터형: half | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

slope — 기울기

3.0518e-05 (디폴트 값) | 0보다 큰 유한한 부동소수점 숫자

기울기로, 0보다 큰 유한한 부동소수점 숫자로 지정됩니다.

기울기와 편향에 따라 고정소수점 숫자의 스케일링이 결정됩니다.

참고

$$slope=slopeadjustmentfactor\times {\text{2}}^{fixedexponent}$$

이러한 속성 중 하나를 변경하면 다른 속성에 영향을 줍니다.

예: T = numerictype(true,16,2^-2,4)

데이터형: half | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

bias — 객체와 연결된 편향

0 (디폴트 값) | 부동소수점 숫자

객체와 연결된 편향으로, 부동소수점 숫자로 지정됩니다.

기울기와 편향에 따라 고정소수점 숫자의 스케일링이 결정됩니다.

예: T = numerictype(true,16,2^-2,4)

데이터형: half | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

slopeadjustmentfactor — 기울기 조정 인자

1 (디폴트 값) | 양의 스칼라

기울기 조정 인자로, 양의 스칼라로 지정됩니다.

기울기 조정 인자는 1보다 크거나 같고 2보다 작아야 합니다. 이 범위 밖의 slopeadjustmentfactor를 입력하는 경우 numerictype 객체가 자동으로 slopeadjustmentfactor 및 fixedexponent 값에 스케일링 정규화를 적용하여 수정된 기울기 조정 인자가 1보다 크거나 같고 2보다 작게 되도록 만들고 기울기의 값을 유지합니다.

기울기 조정은 고정소수점 숫자의 소수부 기울기에 해당합니다.

참고

$$slope=slopeadjustmentfactor\times {\text{2}}^{fixedexponent}$$

이러한 속성 중 하나를 변경하면 다른 속성에 영향을 줍니다.

데이터형: half | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

fixedexponent — 고정소수점 지수

-15 (디폴트 값) | 정수

객체와 연결된 고정소수점 지수로, 정수로 지정됩니다.

참고

FixedExponent 속성은 FractionLength의 음수입니다. 한 속성을 변경하면 다른 속성도 변경됩니다.

데이터형: half | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: F = numerictype('DataTypeMode','Fixed-point: binary point scaling','DataTypeOverride','Inherit')

참고

이름-값 쌍을 사용하여 numerictype 객체를 만들면 Fixed-Point Designer™는 디폴트 numerictype 객체를 만든 다음 생성자에서 지정한 각 속성 이름에 해당 값을 할당합니다. 이 동작은 T = numerictype(s,w)와 같은 구문을 사용하는 경우 발생하는 동작과 다릅니다. Example: Construct a numerictype Object with Property Name and Property Value Pairs 항목을 참조하십시오.

Bias — 편향

0 (디폴트 값) | 부동소수점 숫자

편향으로, 부동소수점 숫자로 지정됩니다.

기울기 및 편향에 따라 고정소수점 숫자의 스케일링이 결정됩니다.

예: T = numerictype('DataTypeMode','Fixed-point: slope and bias scaling','Bias',4)

데이터형: half | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

DataType — 데이터형 범주

'Fixed' (디폴트 값) | 'Boolean' | 'Double' | 'ScaledDouble' | 'Single' | 'Half'

데이터형 범주로, 다음 값 중 하나로 지정됩니다.

• 'Fixed' – 고정소수점 또는 정수 데이터형

• 'Boolean' – 내장 MATLAB^® 부울 데이터형

• 'Double' – 내장 MATLAB double 데이터형

• 'ScaledDouble' – 스케일링된 double 데이터형

• 'Single' – 내장 MATLAB single 데이터형

• 'Half' – MATLAB 반정밀도 데이터형

예: T = numerictype('Double')

데이터형: char

DataTypeMode — 데이터형 및 스케일링 모드

'Fixed-point: binary point scaling' (디폴트 값) | 'Fixed-point: slope and bias scaling' | 'Fixed-point: unspecified scaling' | 'Scaled double: binary point scaling' | 'Scaled double: slope and bias scaling' | 'Scaled double: unspecified scaling' | 'Double' | 'Single' | 'Half' | 'Boolean'

객체와 연결된 데이터형 및 스케일링 모드로, 다음 값 중 하나로 지정됩니다.

• 'Fixed-point: binary point scaling' – 워드 길이와 소수부 길이로 정의되는 고정소수점 데이터형 및 스케일링

• 'Fixed-point: slope and bias scaling' – 기울기 및 편향으로 정의되는 고정소수점 데이터형 및 스케일링

• 'Fixed-point: unspecified scaling' – 스케일링을 지정하지 않은 고정소수점 데이터형

• 'Scaled double: binary point scaling' – 고정소수점 워드 길이 및 소수부 길이 정보가 유지되는 double 데이터형

• 'Scaled double: slope and bias scaling' – 고정소수점 기울기 및 편향 정보가 유지되는 double 데이터형

• 'Scaled double: unspecified scaling' – 고정소수점 스케일링을 지정하지 않은 double 데이터형

• 'Double' – 내장 double형

• 'Single' – 내장 single형

• 'Half' – MATLAB 반정밀도 데이터형

• 'Boolean' – 내장 boolean

예: T = numerictype('DataTypeMode','Fixed-point: binary point scaling')

데이터형: char

DataTypeOverride — 데이터형 재정의 설정

'Inherit' (디폴트 값) | 'Off'

데이터형 재정의 설정으로, 다음 값 중 하나로 지정됩니다.

• 'Inherit' – DataTypeOverride 활성화

• 'Off' – DataTypeOverride 비활성화

참고

DataTypeOverride 속성은 해당 값이 디폴트 값 'Inherit'로 설정된 경우 표시되지 않습니다.

예: T = numerictype('DataTypeOverride','Off')

데이터형: char

FixedExponent — 고정소수점 지수

-15 (디폴트 값) | 정수

객체와 연결된 고정소수점 지수로, 정수로 지정됩니다.

참고

FixedExponent 속성은 FractionLength의 음수입니다. 한 속성을 변경하면 다른 속성도 변경됩니다.

예: T = numerictype('FixedExponent',-12)

데이터형: half | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

FractionLength — 저장된 정수 값의 소수부 길이

최적 정밀도 (디폴트 값) | 정수

저장된 정수 값의 소수부 길이(비트 수)로, 정수로 지정됩니다.

디폴트 값은 객체 값과 워드 길이를 기반으로 한 최적 정밀도의 소수부 길이입니다.

예: T = numerictype('FractionLength',12)

데이터형: half | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Scaling — 고정소수점 스케일링 모드

'BinaryPoint' (디폴트 값) | 'SlopeBias' | 'Unspecified'

객체의 고정소수점 스케일링 모드로, 다음 값 중 하나로 지정됩니다.

• 'BinaryPoint' – numerictype 객체에 대한 스케일링은 소수부 길이로 정의됩니다.

• 'SlopeBias' – numerictype 객체에 대한 스케일링은 기울기 및 편향으로 정의됩니다.

• 'Unspecified' – numerictype 객체 생성 시에만 허용되는 임시 설정으로, 최적 정밀도의 이진 소수점 스케일링의 자동 할당을 허용합니다.

예: T = numerictype('Scaling','BinaryPoint')

데이터형: char

Signed — 객체에 부호가 있는지 여부

true 또는 1 (디폴트 값) | false 또는 0

객체에 부호가 있는지 여부로, 숫자형이나 논리값 1(true) 또는 0(false)으로 지정됩니다.

참고

Signed 속성은 계속 지원되지만 Signedness 속성은 항상 numerictype 객체 표시에 나타납니다. Signed 속성을 사용하여 numerictype 객체의 부호의 유무를 변경하거나 설정하도록 선택하는 경우 MATLAB은 Signedness 속성의 해당 값을 업데이트합니다.

예: T = numerictype('Signed',true)

데이터형: logical

Signedness — 객체에 부호가 있는지 여부

'Signed' (디폴트 값) | 'Unsigned' | 'Auto'

객체에 부호가 있는지 여부로, 다음 값 중 하나로 지정됩니다.

• 'Signed' – 부호 있음

• 'Unsigned' – 부호 없음

• 'Auto' – 부호가 지정되지 않음

참고

부호가 지정되지 않은(Signedness: Auto) numerictype 객체를 만들 수 있지만, 고정소수점 numerictype 객체는 모두 Signedness가 Signed 또는 Unsigned여야 합니다. Signedness: Auto인 numerictype 객체를 사용하여 numerictype 객체를 생성하는 경우 numerictype 객체의 Signedness 속성은 기본적으로 Signed로 자동 설정됩니다.

예: T = numerictype('Signedness','Signed')

데이터형: char

Slope — 기울기

3.0518e-05 (디폴트 값) | 유한한 양의 부동소수점 숫자

기울기로, 유한한 양의 부동소수점 숫자로 지정됩니다.

기울기 및 편향에 따라 고정소수점 숫자의 스케일링이 결정됩니다.

참고

$$slope=slopeadjustmentfactor\times {\text{2}}^{fixedexponent}$$

이러한 속성 중 하나를 변경하면 다른 속성에 영향을 줍니다.

예: T = numerictype('DataTypeMode','Fixed-point: slope and bias scaling','Slope',2^-2)

데이터형: half | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

SlopeAdjustmentFactor — 기울기 조정 인자

1 (디폴트 값) | 양의 스칼라

기울기 조정 인자로, 양의 스칼라로 지정됩니다.

기울기 조정 인자는 1보다 크거나 같고 2보다 작아야 합니다. 이 범위 밖의 slopeadjustmentfactor를 입력하는 경우 numerictype 객체가 자동으로 slopeadjustmentfactor 및 fixedexponent 값에 스케일링 정규화를 적용하여 수정된 기울기 조정 인자가 1보다 크거나 같고 2보다 작게 되도록 만들고 기울기의 값을 유지합니다.

기울기 조정은 고정소수점 숫자의 소수부 기울기에 해당합니다.

참고

$$slope=slopeadjustmentfactor\times {\text{2}}^{fixedexponent}$$

이러한 속성 중 하나를 변경하면 다른 속성에 영향을 줍니다.

예: T = numerictype('DataTypeMode','Fixed-point: slope and bias scaling','SlopeAdjustmentFactor',1.5)

데이터형: half | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

WordLength — 저장된 정수 값의 워드 길이

16 (디폴트 값) | 양의 정수

저장된 정수 값의 워드 길이(비트 수)로, 양의 정수로 지정됩니다.

예: T = numerictype('WordLength',16)

데이터형: half | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

확장 기능

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• Simulink^®에서 MATLAB Function 블록으로 들어오는 고정소수점 신호는 신호의 데이터형 및 스케일링 정보로 채워진 numerictype 객체에 할당됩니다.

• 입력값이 고정소수점 신호가 아닌 경우 데이터형을 반환합니다.

• 생성 코드에서 numerictype 객체를 만드는 데 사용합니다.

• 데이터형과 관련된 모든 numerictype 객체 속성은 상수여야 합니다.

HDL 코드 생성
HDL Coder™를 사용하여 FPGA 및 ASIC 설계를 위한 VHDL, Verilog 및 SystemVerilog 코드를 생성할 수 있습니다.

버전 내역

R2006a 이전에 개발됨

R2021a: fi, fimath, numerictype 객체의 부정확한 속성 이름은 지원되지 않음

이전 릴리스에서는 fi, fimath, numerictype 객체의 부정확한 속성 이름을 사용할 경우 경고가 발생합니다. R2021a에서는 부정확한 속성 이름에 대한 지원이 제거되었습니다. 대신 정확한 속성 이름을 사용하십시오.

참고 항목

fi | fimath | fipref | quantizer

도움말 항목

• numerictype Objects Usage to Share Data Type and Scaling Settings of fi objects
• numerictype Object Properties