sqrt
제곱근
설명
B = sqrt(
는 배열 X
)X
의 각 요소에 대한 제곱근을 반환합니다. X
의 요소가 음수나 복소수인 경우, sqrt(X)
는 복소수 결과를 산출합니다.
sqrt
함수의 영역에는 음수와 복소수가 포함되므로, 의도치 않게 사용할 경우 예기치 않은 결과를 일으킬 수 있습니다. 음수와 복소수 z = u + i*w
에 대해 복소수 제곱근 sqrt(z)
는 다음을 반환합니다.
sqrt(r)*(cos(phi/2) + 1i*sin(phi/2))
여기서 r = abs(z)
는 반지름이고 phi = angle(z)
는 닫힌 구간 -pi <= phi <= pi
에서의 위상각입니다.
음수와 복소수에 대해 복소수 결과값을 반환하는 대신 오류 메시지를 반환하려면 realsqrt
를 대신 사용하십시오.
예제
벡터 요소의 제곱근
음수와 양수 값을 모두 포함하는 행 벡터를 만듭니다.
X = -2:2
X = 1×5
-2 -1 0 1 2
각 X
요소의 제곱근을 계산합니다.
Y = sqrt(X)
Y = 1×5 complex
0.0000 + 1.4142i 0.0000 + 1.0000i 0.0000 + 0.0000i 1.0000 + 0.0000i 1.4142 + 0.0000i
입력 인수
X
— 입력 배열
스칼라 | 벡터 | 행렬 | 다차원 배열 | 테이블 | 타임테이블
입력 배열로, 숫자형 스칼라, 벡터, 행렬, 다차원 배열, 테이블 또는 타임테이블로 지정됩니다.
데이터형: single
| double
| table
| timetable
복소수 지원 여부: 예
세부 정보
IEEE 준수
실수 입력값에 대해 sqrt
는 IEEE®-754 표준의 권고 사항과는 다르게 동작하는 부분이 있습니다. 특히 음수 입력값은 NaN
대신 복소수 결과값을 생성합니다.
MATLAB® | IEEE | |
---|---|---|
|
|
|
|
|
|
팁
행렬 제곱근에 대해서는
sqrtm
을 참조하십시오.
확장 기능
tall형 배열
메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.
이 함수는 tall형 배열을 완전히 지원합니다. 자세한 내용은 tall형 배열 항목을 참조하십시오.
C/C++ 코드 생성
MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.
사용법 관련 참고 및 제한 사항:
시뮬레이션 시 오류가 발생합니다. 생성된 독립 실행형 코드는 입력값
x
가 실수인데 출력값은 복소수인 경우NaN
을 반환합니다. 복소수 결과값을 얻으려면 입력값을complex(x)
에 전달하여 복소수로 만드십시오.독립형 대상에 대한 코드를 생성하는 경우 MATLAB 코드에 있는
sqrt
에 대한 입력값이 상수가 아니면 생성된 코드가sqrt(-0)
에 대해 반환하는 값은 C/C++ 컴파일러의 표준 라이브러리 함수가 반환하는 값과 같습니다. 표준 라이브러리 함수가 IEEE-754 표준을 준수하는 경우 생성된 코드는-0
을 반환합니다.
GPU 코드 생성
GPU Coder™를 사용하여 NVIDIA® GPU용 CUDA® 코드를 생성할 수 있습니다.
사용법 관련 참고 및 제한 사항:
시뮬레이션 시 오류가 발생합니다. 생성된 독립 실행형 코드는 입력값
x
가 실수인데 출력값은 복소수인 경우NaN
을 반환합니다. 복소수 결과값을 얻으려면 입력값을complex(x)
에 전달하여 복소수로 만드십시오.
스레드 기반 환경
MATLAB®의 backgroundPool
을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool
을 사용해 코드 실행 속도를 높일 수 있습니다.
이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.
GPU 배열
Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.
사용법 관련 참고 및 제한 사항:
GPU에서 실행되는 함수의 출력값이 복소수일 수 있는 경우, 이 함수의 입력 인수를 명시적으로 복소수로 지정해야 합니다. 자세한 내용은 GPU에서 복소수 사용하기 (Parallel Computing Toolbox) 항목을 참조하십시오.
자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.
분산 배열
Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.
이 함수는 분산 배열을 완전히 지원합니다. 자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.
버전 내역
R2006a 이전에 개발됨R2023a: 테이블 및 타임테이블에 대해 직접 계산 수행
sqrt
함수는 테이블이나 타임테이블 내의 변수에 액세스하기 위한 인덱싱 없이 이러한 모든 변수에 대해 계산을 수행할 수 있습니다. 모든 변수는 계산을 지원하는 데이터형을 가져야 합니다. 자세한 내용은 Direct Calculations on Tables and Timetables 항목을 참조하십시오.
MATLAB 명령
다음 MATLAB 명령에 해당하는 링크를 클릭했습니다.
명령을 실행하려면 MATLAB 명령 창에 입력하십시오. 웹 브라우저는 MATLAB 명령을 지원하지 않습니다.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)