이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

log2

기수 2 로그 및 부동소수점 숫자 분해

구문

Y = log2(X)

[F,E] = log2(X)

설명

Y = log2(X)는 $$2^Y=X$$가 되도록 X의 요소에 대한 기수 2 로그를 계산합니다.

[F,E] = log2(X)는 $$X=F\cdot 2^E$$을 충족하는 배열 F와 E를 반환합니다. F에 있는 값은 통상적으로 범위 0.5 <= abs(F) < 1 내에 있습니다.

예제

기수 2 로그 값

X = [0 1 2 10 Inf NaN];
Y = log2(X)

Y = 1×6

      -Inf         0    1.0000    3.3219       Inf       NaN

부동소수점 숫자 분해

여러 개의 숫자를 지수와 가수로 분해합니다. 이러한 연산은 모두 표준 IEEE® 산술 방식을 따릅니다.

여러 개의 테스트 값이 포함되어 있는 벡터 X를 만듭니다. 각 요소의 지수와 가수를 계산합니다.

X = [1 pi -3 eps realmax realmin];
format rat
[F,E] = log2(X)

F = 
       1/2          355/452         -3/4            1/2            1              1/2     

E = 
       1              2              2            -51           1024          -1021       

결과를 테이블에 수집하십시오. 표시 목적으로 숫자를 문자형 벡터로 변환합니다.

x = {'1','pi','-3','eps','realmax','realmin'}';
f = strtrim(cellstr(rats(F')));
T = table(x,f,E','VariableNames',{'Value','Mantissa','Exponent'})

T=6×3 table
       Value        Mantissa      Exponent
    ___________    ___________    ________

    {'1'      }    {'1/2'    }         1  
    {'pi'     }    {'355/452'}         2  
    {'-3'     }    {'-3/4'   }         2  
    {'eps'    }    {'1/2'    }       -51  
    {'realmax'}    {'1'      }      1024  
    {'realmin'}    {'1/2'    }     -1021  

그 결과를 보면 첫 번째 행의 경우 $1=\frac{1}{2}\left(2^1\right)$임을 알 수 있습니다. 이와 유사하게, 네 번째 행의 경우, $\mathrm{eps}=\frac{1}{2}\left(2^{-51}\right)$입니다.

입력 인수

X — 입력 행렬

스칼라 | 벡터 | 행렬 | 다차원 배열 | 테이블 | 타임테이블

입력 행렬로, 스칼라, 벡터, 행렬, 다차원 배열, 테이블 또는 타임테이블로 지정됩니다.

[F,E] = log2(X)에 대한 부동소수점 숫자 분해의 경우, X에 0이 있으면 F = 0과 E = 0이라는 결과가 나옵니다. 입력값에 있는 Inf, -Inf 또는 NaN은 이에 대응하는 지수 E = 0과 함께 F에서 변경 없이 반환됩니다.

데이터형: single | double | table | timetable
복소수 지원 여부: 예

출력 인수

Y — 기수 2 로그 값

스칼라 | 벡터 | 행렬 | 다차원 배열 | 테이블 | 타임테이블

기수 2 로그 값으로, X와 동일한 크기의 스칼라, 벡터, 행렬, 다차원 배열, 테이블 또는 타임테이블로 반환됩니다.

F — 가수 값

스칼라 | 벡터 | 행렬 | 다차원 배열 | 테이블 | 타임테이블

가수 값으로, X와 동일한 크기의 스칼라, 벡터, 행렬, 다차원 배열, 테이블 또는 타임테이블로 반환됩니다. F와 E의 값은 X = F.*2.^E을 만족합니다.

E — 지수 값

스칼라 | 벡터 | 행렬 | 다차원 배열 | 테이블 | 타임테이블

지수 값으로, X와 동일한 크기의 스칼라, 벡터, 행렬, 다차원 배열, 테이블 또는 타임테이블로 반환됩니다. F와 E의 값은 X = F.*2.^E을 만족합니다.

팁

• 이 함수는 ANSI^® C 함수 frexp()와 IEEE^® 부동소수점 표준 함수 logb()에 대응합니다. X에 0이 있으면 F = 0이 되고 E = 0이 됩니다.

확장 기능

tall형 배열

메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.

log2 함수는 tall형 배열을 완전히 지원합니다. 자세한 내용은 tall형 배열 항목을 참조하십시오.

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

GPU 코드 생성
GPU Coder™를 사용하여 NVIDIA® GPU용 CUDA® 코드를 생성할 수 있습니다.

스레드 기반 환경

MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

GPU 배열

Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

log2 함수는 GPU 배열 입력값을 지원하지만 다음과 같은 사용법 관련 참고 및 제한 사항이 있습니다.

• 구문 [F,E] = log2(X)는 지원되지 않습니다.

• GPU에서 실행되는 함수의 출력값이 복소수일 수 있는 경우, 이 함수의 입력 인수를 명시적으로 복소수로 지정해야 합니다. 자세한 내용은 GPU에서 복소수 사용하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

분산 배열

Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.

이 함수는 분산 배열을 완전히 지원합니다. 자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

R2025a: 2-출력값 구문에 대한 복소수 입력값은 허용되지 않을 예정임

2-출력값 구문을 사용할 때 복소수 입력값을 지정할 경우 log2 함수가 경고를 발생시킵니다. 이 구문에서 복소수 입력값에 대한 지원은 향후 릴리스에서 제거될 예정입니다. 이전 릴리스에서 log2의 2-출력값 구문을 사용하면 복소수 입력값의 허수부가 무시되고 실수부만 처리되었습니다.

이전 릴리스의 동작을 그대로 유지하려면 다음 표에 나와 있는 대로 real 함수를 사용하여 복소수 입력값의 실수부를 추출하십시오.

권장되지 않음(경고)	권장됨
X = 2 - 1i; [F,E] = log2(X);	X = 2 - 1i; [F,E] = log2(real(X));

R2023a: 테이블 및 타임테이블에 대해 직접 계산 수행

log2 함수는 테이블이나 타임테이블 내의 변수에 액세스하기 위한 인덱싱 없이 이러한 모든 변수에 대해 계산을 수행할 수 있습니다. 모든 변수는 계산을 지원하는 데이터형을 가져야 합니다. 자세한 내용은 테이블 및 타임테이블에 대해 직접 계산 항목을 참조하십시오.

참고 항목

log10 | log | pow2