log

자연 로그(Natural Logarithm)

구문

Y = log(X)

설명

Y = log(X)는 배열 X의 각 요소에 대한 자연 로그 ln(x)를 반환합니다.

log 함수의 영역에는 음수와 복소수가 포함되므로, 의도치 않게 사용할 경우 예기치 않은 결과를 일으킬 수 있습니다. 음수와 복소수 z = u + i*w에 대해 복소 로그 log(z)는 다음을 반환합니다.

log(abs(z)) + 1i*angle(z)

음수와 복소수에 대해 복소수 결과값을 반환하는 대신 오류 메시지를 반환하려면 reallog를 대신 사용하십시오.

예제

음수의 자연 로그

-1의 자연 로그가 $$i\pi$$임을 보여줍니다.

log(-1)

ans = 
0.0000 + 3.1416i

입력 인수

X — 입력 배열

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

입력 배열로, 스칼라, 벡터, 행렬, 다차원 배열, table형 또는 timetable형으로 지정됩니다.

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

출력 인수

Y — 로그 값

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

로그 값으로, 스칼라, 벡터, 행렬, 다차원 배열, 테이블 또는 타임테이블로 반환됩니다.

X가 구간 (0, Inf)에 있는 양의 실수 값이라면 Y는 구간 (-Inf, Inf)에 있게 됩니다. X가 복소수 값이나 음의 실수 값을 가지면 Y는 복소수 값을 갖게 됩니다. Y의 데이터형은 X의 데이터형과 같습니다.

확장 기능

tall형 배열

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

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

C/C++ 코드 생성

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

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

• 입력 인수 x가 실수이지만, 출력값이 복소수여야 하는 경우 시뮬레이션에서 오류가 발생합니다. 복소수 결과값을 생성하려면 complex(x)를 전달하여 입력값을 복소수로 지정하십시오.

GPU 코드 생성

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

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

• 입력 인수 x가 실수이지만, 출력값이 복소수여야 하는 경우 시뮬레이션에서 오류가 발생합니다. 복소수 결과값을 생성하려면 complex(x)를 전달하여 입력값을 복소수로 지정하십시오.

스레드 기반 환경

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

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

GPU 배열

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

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

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

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

분산 배열

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

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

버전 내역

R2006a 이전에 개발됨

R2026a: 배정밀도의 성능이 향상됨

log 함수로 자연 로그를 배정밀도로 계산할 때의 성능이 향상되었습니다. 예를 들어, 다음 코드는 0에서 1,000 구간에서 100,000,000개 실수의 자연 로그를 계산합니다. 이 코드는 이전 릴리스보다 약 2.8배 빠릅니다.

function t = timingLog
x = rand(1,1e8)*1000;
y = @() log(x);
t = timeit(y);
end

대략적인 실행 시간은 다음과 같습니다.

R2025a: 0.79초

R2026a: 0.28초

코드 실행 시간은 Windows^® 11, AMD EPYC™ 74F3 24-Core Processor @ 3.19GHz 테스트 시스템에서 timingLog 함수를 호출하여 측정했습니다.

호환성 관련 고려 사항

이 성능 향상은 코드 변경에서 비롯되며, 이 변경으로 인해 배정밀도에서의 반올림 동작도 약간 달라져 전반적으로 더 정확한 결과를 도출합니다. 예를 들어, 다음 코드는 이제 과학 표기법에서 소수점 이하 15번째 자리까지 더 정확한 결과를 반환합니다.

format longE
Y = log(1.63340913276288)

Y =
     4.906693231856701e-01

이전에는 동일한 코드가 다음과 같은 결과를 반환했습니다.

format longE
Y = log(1.63340913276288)

Y =
     4.906693231856700e-01

MATLAB^®은 1.63340913276288과 같은 10진수 입력값을 표현 가능한 최근접 배정밀도 이진 값으로 변환하므로, 원래의 10진수 입력과 정확히 일치하지 않을 수 있습니다. 이러한 이유로 log 함수는 이제 배정밀도에서 더 정확하지만, 입력값의 정확한 표현을 사용한 계산과는 결과가 다를 수 있습니다.

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

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

참고 항목

log1p | log2 | log10 | exp | logm | reallog | loglog | semilogx | semilogy