power, .^

요소별 거듭제곱

구문

C = A.^B

C = power(A,B)

설명

C = A.^B는 A의 각 요소를 밑으로 하고 이에 대응하는 B의 요소를 지수로 하는 거듭제곱을 계산합니다. A와 B는 크기가 같거나 호환 가능해야 합니다.

A와 B의 크기가 호환되는 경우에는 두 배열이 서로 일치하도록 묵시적으로 확장됩니다. 예를 들어, A 또는 B 중 하나가 스칼라인 경우에는 스칼라가 다른 배열의 각 요소와 결합됩니다. 또한 방향이 서로 다른 벡터(행 벡터 1개와 열 벡터 1개)가 묵시적으로 확장되어 행렬을 형성합니다.

C = power(A,B)는 A.^B를 실행하는 또 다른 방법이지만 거의 사용되지 않습니다. 이 표현식은 클래스에 대한 연산자 오버로드를 지원합니다.

예제

벡터의 각 요소에 대한 제곱 구하기

벡터 A를 만들고 각 요소에 대한 제곱을 구합니다.

A = 1:5;
C = A.^2

C = 1×5

     1     4     9    16    25

각 행렬 요소에 대한 역 구하기

행렬 A를 만들고 각 요소에 대한 역을 구합니다.

A = [1 2 3; 4 5 6; 7 8 9];
C = A.^-1

C = 3×3

    1.0000    0.5000    0.3333
    0.2500    0.2000    0.1667
    0.1429    0.1250    0.1111

요소에 대한 역은 행렬의 역행렬과 같지 않습니다. 행렬의 역행렬은 A^-1이나 inv(A)로 표기합니다.

행 벡터를 열 벡터로 거듭제곱하기

1×2 행 벡터와 3×1 열 벡터를 만들고 행 벡터를 열 벡터로 거듭제곱합니다.

a = [2 3];
b = (1:3)';
a.^b

ans = 3×2

     2     3
     4     9
     8    27

결과는 3×2 행렬이며, 여기서 행렬에 있는 각각의 (i,j) 요소는 a(j) .^ b(i)와 같습니다.

$$\mathit{a}=\left[{\mathit{a}}_1{\mathit{a}}_2\right],\mathit{b}=\left[\begin{array}{c}{\mathit{b}}_1\\ {\mathit{b}}_2\\ {\mathit{b}}_3\end{array}\right],\mathit{a}.ˆ\mathit{b}=\left[\begin{array}{cc}{{\mathit{a}}_1}^{{\mathit{b}}_1}& {{\mathit{a}}_2}^{{\mathit{b}}_1}\\ {{\mathit{a}}_1}^{{\mathit{b}}_2}& {{\mathit{a}}_2}^{{\mathit{b}}_2}\\ {{\mathit{a}}_1}^{{\mathit{b}}_3}& {{\mathit{a}}_2}^{{\mathit{b}}_3}\end{array}\right].$$

숫자의 제곱근 구하기

-1의 1/3제곱에 대한 근을 계산합니다.

A = -1;
B = 1/3;
C = A.^B

C = 0.5000 + 0.8660i

음수의 밑 A와 정수가 아닌 B의 경우 power 함수는 복소수 결과를 반환합니다.

nthroot 함수를 사용하여 실근을 구합니다.

C = nthroot(A,3)

C = -1

다른 테이블을 지수로 하여 테이블을 거듭제곱

R2023a 이상

두 개의 테이블을 만든 다음 두 번째 테이블을 지수로 하여 첫 번째 테이블을 거듭제곱합니다. 행 이름(두 테이블에 모두 있는 경우)과 변수 이름은 동일해야 하지만, 순서는 같지 않아도 됩니다. 출력값의 행과 변수는 첫 번째 입력값과 순서가 동일합니다.

A = table([1;2],[3;4],VariableNames=["V1","V2"],RowNames=["R1","R2"])

A=2×2 table
          V1    V2
          __    __

    R1    1     3 
    R2    2     4 

B = table([4;2],[3;1],VariableNames=["V2","V1"],RowNames=["R2","R1"])

B=2×2 table
          V2    V1
          __    __

    R2    4     3 
    R1    2     1 

C = A .^ B

C=2×2 table
          V1    V2 
          __    ___

    R1    1       9
    R2    8     256

입력 인수

A, B — 피연산자

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

피연산자로, 스칼라, 벡터, 행렬, 다차원 배열, 테이블 또는 타임테이블로 지정됩니다. A와 B는 동일한 크기이거나 호환되는 크기를 가져야 합니다. 후자의 예로는 A가 M×N 행렬이고 B가 스칼라이거나 1×N 행 벡터인 경우를 들 수 있습니다. 자세한 내용은 기본 연산에 대해 호환되는 배열 크기 항목을 참조하십시오.

• 정수 데이터형을 가진 피연산자는 복소수일 수 없습니다.

테이블이거나 타임테이블인 입력값은 다음 조건을 충족해야 합니다. (R2023a 이후)

• 입력값이 테이블 또는 타임테이블인 경우 해당 테이블의 모든 변수는 연산을 지원하는 데이터형을 가져야 합니다.

• 입력값 중 하나만 테이블 또는 타임테이블인 경우 다른 입력값은 숫자형 배열이거나 논리형 배열이어야 합니다.

• 두 입력값이 모두 테이블 또는 타임테이블인 경우에는 다음을 충족해야 합니다.

  • 두 입력값의 크기가 동일하거나, 두 입력값 중 하나가 행이 한 개 있는 테이블이어야 합니다.

  • 두 입력값이 모두 동일한 이름의 변수를 가져야 합니다. 그러나 각 입력값의 변수 순서는 다를 수 있습니다.

  • 두 입력값이 모두 테이블이고 두 테이블 모두 행 이름을 갖는 경우 두 테이블의 행 이름은 동일해야 합니다. 그러나 각 입력값의 행 이름 순서는 다를 수 있습니다.

  • 두 입력값이 모두 타임테이블인 경우 두 테이블의 행 시간값은 동일해야 합니다. 그러나 각 입력값의 행 시간값 순서는 다를 수 있습니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | table | timetable
복소수 지원 여부: 예

세부 정보

IEEE 준수

power는 실수 입력값에 대해 IEEE^®-754 표준에서 권고하는 것과 다르게 동작하는 경우가 몇 가지 있습니다.

	MATLAB®	IEEE
power(1,NaN)	NaN	1
power(NaN,0)	NaN	1

확장 기능

tall형 배열

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

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

C/C++ 코드 생성

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

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

• X와 Y가 모두 실수이지만 power(X,Y)가 복소수인 경우 시뮬레이션은 오류를 생성하고, 생성된 코드는 NaN을 반환합니다. 복소수 결과값을 얻으려면 입력 인수 X를 complex(X)에 전달하여 복소수로 만드십시오. 예를 들면 power(complex(X),Y)와 같습니다.

• X와 Y가 모두 실수이지만 X .^ Y가 복소수인 경우 시뮬레이션은 오류를 생성하고, 생성된 코드는 NaN을 반환합니다. 복소수 결과값을 얻으려면 complex(X)를 사용하여 입력 인수 X를 복소수로 만드십시오. 예를 들면 complex(X).^Y와 같습니다.

• 코드 생성 시 이 함수에 대해 희소 행렬 입력값은 지원되지 않습니다.

GPU 코드 생성

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

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

• X와 Y가 모두 실수이지만 power(X,Y)가 복소수인 경우 시뮬레이션은 오류를 생성하고, 생성된 코드는 NaN을 반환합니다. 복소수 결과값을 얻으려면 입력 인수 X를 complex(X)에 전달하여 복소수로 만드십시오. 예를 들면 power(complex(X),Y)와 같습니다.

• X와 Y가 모두 실수이지만 X .^ Y가 복소수인 경우 시뮬레이션은 오류를 생성하고, 생성된 코드는 NaN을 반환합니다. 복소수 결과값을 얻으려면 complex(X)를 사용하여 입력 인수 X를 복소수로 만드십시오. 예를 들면 complex(X).^Y와 같습니다.

• 코드 생성 시 이 함수에 대해 희소 행렬 입력값은 지원되지 않습니다.

HDL 코드 생성

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

두 입력값 모두 스칼라여야 하고 지수 입력값 k는 정수여야 합니다.

스레드 기반 환경

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

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

GPU 배열

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

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

• 64비트 정수는 지원되지 않습니다.

• 밑 A 또는 지수 B가 희소 형식인 경우 B는 스칼라여야 합니다.

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

분산 배열

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

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

버전 내역

R2006a 이전에 개발됨

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

power 연산자는 테이블이나 타임테이블 내의 변수에 액세스하기 위한 인덱싱 없이 테이블과 타임테이블에 대한 직접 연산을 지원합니다. 모든 변수는 연산을 지원하는 데이터형을 가져야 합니다. 자세한 내용은 Direct Calculations on Tables and Timetables 항목을 참조하십시오.

R2016b: 묵시적 확장 변경 사항이 연산자의 인수에 영향을 줌

R2016b부터는 묵시적 확장이 추가되어, 이전에 오류를 반환했던 기본 연산을 위한 일부 인수 조합이 이제는 결과를 생성합니다. 예를 들어, 이전에는 행 벡터와 열 벡터를 더할 수 없었지만 이제는 이러한 피연산자들도 덧셈에서 유효합니다. 즉, [1 2] + [1; 2]와 같은 표현식은 이전에 크기 불일치 오류를 반환했지만 이제는 실행됩니다.

요소별 연산자를 사용하는 코드이면서 MATLAB이 이전에 크기 불일치에 대해(특히 try/catch 블록 내에서) 반환하던 오류에 의존하는 코드라면, 해당 코드는 더 이상 이러한 오류를 캐치하지 않을 수 있습니다.

기본 배열 연산에 필요한 입력 크기에 대한 자세한 내용은 기본 연산에 대해 호환되는 배열 크기 항목을 참조하십시오.

참고 항목

realpow | mpower | nthroot

도움말 항목

• 배열 연산과 행렬 연산
• 연산자 우선 순위
• MATLAB 연산자와 특수 문자