atanh

역쌍곡탄젠트(Inverse Hyperbolic Tangent)

구문

Y = atanh(X)

설명

Y = atanh(X)는 X의 요소들에 대한 역쌍곡탄젠트 값을 반환합니다. 이 함수는 실수와 복소수 입력값을 모두 받습니다. 모든 각도의 단위는 라디안입니다.

예제

벡터의 역쌍곡탄젠트

벡터 X의 요소에 대한 역쌍곡탄젠트를 구합니다. atanh 함수는 X에 대해 요소별로 동작을 수행합니다.

X = [2 -3 1+2i];
Y = atanh(X)

Y = 1×3 complex

   0.5493 + 1.5708i  -0.3466 - 1.5708i   0.1733 + 1.1781i

역쌍곡탄젠트 함수 플로팅하기

구간 $$-1<x<1$$에 대해 역쌍곡탄젠트 함수를 플로팅합니다.

x = -0.99:0.01:0.99; 
plot(x,atanh(x))
grid on
xlabel('x')
ylabel('atanh(x)')

입력 인수

X — 각도의 쌍곡탄젠트

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

각도의 쌍곡탄젠트로, 스칼라, 벡터, 행렬, 다차원 배열, 테이블 또는 타임테이블로 지정됩니다. X가 스칼라 값이 아니면 atanh 연산은 요소별로 수행됩니다.

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

세부 정보

역쌍곡탄젠트(Inverse Hyperbolic Tangent)

정의역 $$-1<x<1$$의 실수 값 $$x$$에 대해 역쌍곡탄젠트는 다음을 충족합니다.

$${\tanh }^{-1}\left(x\right)=\frac{1}{2}\log \left(\frac{1+x}{1-x}\right).$$

정의역 $$-\infty <z<-1$$과 정의역 $$1<z<\infty$$의 실수 값뿐 아니라 복소수 $$z=x+iy$$에 대해, 호출 atanh(z)는 복소수 결과값을 반환합니다.

확장 기능

tall형 배열

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

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

C/C++ 코드 생성

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

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

• 입력값 x는 실수지만 출력값은 복소수여야 하는 경우 시뮬레이션 중에 오류를 생성하고 생성된 코드에서 NaN을 반환합니다. 복소수 결과값을 얻으려면 입력값을 complex(x)에 전달하여 복소수로 만드십시오.

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

스레드 기반 환경

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

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

GPU 배열

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

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

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

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

분산 배열

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

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

버전 내역

R2006a 이전에 개발됨

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

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

참고 항목

atan2 | atan | tanh | asinh | acosh