이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.
mean
배열의 평균값(Mean Value)
구문
설명
M = mean(
는 크기가 1보다 큰 첫 번째 배열 차원에서 A
)A
의 요소의 평균값을 반환합니다.
A
가 벡터인 경우mean(A)
는 요소의 평균값을 반환합니다.A
가 행렬인 경우mean(A)
는 각 열의 평균값이 포함된 행 벡터를 반환합니다.A
가 다차원 배열인 경우mean(A)
는 크기가 1보다 큰 첫 번째 배열 차원을 따라 연산을 수행하며, 요소를 벡터로 취급합니다. 이 차원에서M
의 크기는1
이 되고, 다른 모든 차원의 크기는A
와 동일하게 유지됩니다.A
가 테이블 또는 타임테이블인 경우mean(A)
는 각 변수의 평균값을 포함하는 한 행 크기의 테이블을 반환합니다. (R2023a 이후)
M = mean(___,
은 위에 열거된 구문에 대해 지정된 데이터형을 갖는 평균값을 반환합니다. outtype
)outtype
은 "default"
, "double"
또는 "native"
일 수 있습니다.
M = mean(___,
는 missingflag
)A
의 누락값을 포함시킬지 또는 생략할지 여부를 지정합니다. 예를 들어, mean(A,"omitmissing")
은 평균값을 구할 때 모든 누락값을 무시합니다. 기본적으로 mean
은 누락값을 포함합니다.
예제
행렬 열의 평균값
행렬을 만든 다음, 각 열의 평균값을 구합니다.
A = [0 1 1; 2 3 2; 1 3 2; 4 2 2]
A = 4×3
0 1 1
2 3 2
1 3 2
4 2 2
M = mean(A)
M = 1×3
1.7500 2.2500 1.7500
행렬 행의 평균값
행렬을 만든 다음, 각 행의 평균값을 구합니다.
A = [0 1 1; 2 3 2; 3 0 1; 1 2 3]
A = 4×3
0 1 1
2 3 2
3 0 1
1 2 3
M = mean(A,2)
M = 4×1
0.6667
2.3333
1.3333
2.0000
3차원 배열의 평균값
1과 10 사이의 정수로 구성된 4×2×3 배열을 만든 다음, 두 번째 차원에서의 평균값을 구합니다.
rng('default')
A = randi(10,[4,2,3]);
M = mean(A,2)
M = M(:,:,1) = 8.0000 5.5000 2.5000 8.0000 M(:,:,2) = 10.0000 7.5000 5.5000 6.0000 M(:,:,3) = 6.0000 5.5000 8.5000 10.0000
배열 페이지의 평균값
3차원 배열을 만들고 데이터의 각 페이지(행과 열)에 대한 평균값을 구합니다.
A(:,:,1) = [2 4; -2 1]; A(:,:,2) = [9 13; -5 7]; A(:,:,3) = [4 4; 8 -3]; M1 = mean(A,[1 2])
M1 = M1(:,:,1) = 1.2500 M1(:,:,2) = 6 M1(:,:,3) = 3.2500
배열의 모든 차원에 대한 평균값을 구하려면 벡터 차원 인수에 각 차원을 지정하거나 "all"
옵션을 사용할 수 있습니다.
M2 = mean(A,[1 2 3])
M2 = 3.5000
Mall = mean(A,"all")
Mall = 3.5000
단정밀도 배열의 평균값
1로 구성된 단정밀도 벡터를 만든 다음, 단정밀도 평균값을 구합니다.
A = single(ones(10,1));
M = mean(A,"native")
M = single
1
결과 역시 단정밀도입니다.
class(M)
ans = 'single'
누락값을 제외한 평균값
NaN
값이 포함된 행렬을 만듭니다.
A = [1.77 -0.005 NaN -2.95; NaN 0.34 NaN 0.19]
A = 2×4
1.7700 -0.0050 NaN -2.9500
NaN 0.3400 NaN 0.1900
누락값을 제외하고 행렬의 평균값을 구합니다. NaN
값이 포함된 행렬 열의 경우 mean
은 NaN
이 아닌 요소에 대해 계산을 수행합니다. 값이 모두 NaN
인 행렬 열의 경우 평균값은 NaN
이 됩니다.
M = mean(A,"omitnan")
M = 1×4
1.7700 0.1675 NaN -1.3800
입력 인수
A
— 입력 배열
벡터 | 행렬 | 다차원 배열 | 테이블 | 타임테이블
입력 배열로, 벡터, 행렬, 다차원 배열, table형 또는 timetable형으로 지정됩니다.
A
가 스칼라이면mean(A)
는A
를 반환합니다.A
가 빈 0×0 행렬인 경우mean(A)
는NaN
을 반환합니다.
데이터형: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
| char
| datetime
| duration
| table
| timetable
dim
— 연산을 수행할 차원
양의 정수 스칼라
연산을 수행할 차원으로, 양의 정수 스칼라로 지정됩니다. 차원을 지정하지 않을 경우 디폴트 값은 크기가 1보다 큰 첫 번째 배열 차원이 됩니다.
차원 dim
은 길이가 1
로 줄어드는 차원을 나타냅니다. size(M,dim)
은 1
이 되고, 다른 모든 차원의 크기는 변경되지 않습니다.
m
×n
입력 행렬 A
가 있다고 가정합니다.
mean(A,1)
은A
의 각 열에서 요소들의 평균값을 구하고,1
×n
행 벡터를 반환합니다.mean(A,2)
는A
의 각 행에서 요소들의 평균값을 구하고,m
×1
열 벡터를 반환합니다.
dim
이 ndims(A)
보다 크거나 size(A,dim)
이 1
인 경우 mean
은 A
를 반환합니다.
vecdim
— 차원의 벡터
양의 정수로 구성된 벡터
차원의 벡터로, 양의 정수로 구성된 벡터로 지정됩니다. 각 요소는 입력 배열의 차원을 나타냅니다. 지정된 연산 차원의 출력값의 길이는 1이고, 다른 모든 차원의 길이는 변경되지 않습니다.
2×3×3 입력 배열 A
가 있다고 가정하겠습니다. 이때 mean(A,[1 2])
는 A
의 각 페이지의 평균값을 요소로 갖는 1×1×3 배열을 반환합니다.
outtype
— 출력 데이터형
"default"
(디폴트 값) | "double"
| "native"
출력 데이터형으로, 다음 표에 있는 값 중 하나로 지정됩니다. 이러한 옵션은 또한 연산을 수행할 때 사용되는 데이터형을 지정합니다.
outtype | 출력 데이터형 |
---|---|
"default" | double 형(단, 입력 데이터형이 single 형, duration 형, datetime 형, table 형 또는 timetable 형이 아닌 경우. 입력 데이터형이 이 중 하나일 때 출력값은 "native" 가 됩니다.) |
"double" | double 형(단, 데이터 입력 유형이 duration 형, datetime 형, table 형 또는 timetable 형이 아닌 경우. 데이터형이 이 중 하나이면 "double" 이 지원되지 않습니다.) |
"native" | 입력값과 동일한 데이터형. 단, 다음 경우에 한합니다.
|
missingflag
— 누락값 조건
"includemissing"
(디폴트 값) | "includenan"
| "includenat"
| "omitmissing"
| "omitnan"
| "omitnat"
누락값 조건으로, 다음 표에 있는 값 중 하나로 지정됩니다.
값 | 입력 데이터형 | 설명 |
---|---|---|
"includemissing" | 지원되는 모든 데이터형 | 평균값을 구할 때 |
"includenan" | double , single , duration | |
"includenat" | datetime | |
"omitmissing" | 지원되는 모든 데이터형 | A 의 누락값을 무시하고, 더 적은 수의 점을 대상으로 평균값을 계산합니다. 연산 차원의 모든 요소가 누락값인 경우 이에 대응하는 M 의 요소도 누락값입니다. |
"omitnan" | double , single , duration | |
"omitnat" | datetime |
세부 정보
평균값
N개의 스칼라 관측값으로 구성된 유한 길이 벡터 A에 대해, 평균값은 다음과 같이 정의됩니다.
확장 기능
tall형 배열
메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.
이 함수는 tall형 배열을 완전히 지원합니다. 자세한 내용은 tall형 배열 항목을 참조하십시오.
C/C++ 코드 생성
MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.
사용법 관련 참고 및 제한 사항:
dim
을 지정할 경우 그 값은 상수여야 합니다.outtype
옵션과missingflag
옵션은 상수 문자형 벡터 또는 string형이어야 합니다.정수형은
"native"
출력 데이터형 옵션을 지원하지 않습니다.Variable-Sizing Restrictions for Code Generation of Toolbox Functions (MATLAB Coder) 항목을 참조하십시오.
GPU 코드 생성
GPU Coder™를 사용하여 NVIDIA® GPU용 CUDA® 코드를 생성할 수 있습니다.
사용법 관련 참고 및 제한 사항:
dim
을 지정할 경우 그 값은 상수여야 합니다.outtype
옵션과missingflag
옵션은 상수 문자형 벡터 또는 string형이어야 합니다.정수형은
"native"
출력 데이터형 옵션을 지원하지 않습니다.
스레드 기반 환경
MATLAB®의 backgroundPool
을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool
을 사용해 코드 실행 속도를 높일 수 있습니다.
이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.
GPU 배열
Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.
mean
함수는 GPU 배열을 부분적으로 지원합니다. 입력 데이터를 gpuArray
(Parallel Computing Toolbox)로 지정하면 이 함수의 일부 구문이 GPU에서 실행됩니다. 사용법 관련 참고 및 제한 사항:
"native"
옵션은 지원되지 않습니다.
자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.
분산 배열
Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.
사용법 관련 참고 및 제한 사항:
"native"
옵션은 지원되지 않습니다.
자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.
버전 내역
R2006a 이전에 개발됨R2023a: 테이블 및 타임테이블에 대해 직접 계산 수행
mean
함수는 테이블이나 타임테이블 내의 변수에 액세스하기 위한 인덱싱 없이 이러한 모든 변수에 대해 계산을 수행할 수 있습니다. 모든 변수는 계산을 지원하는 데이터형을 가져야 합니다. 자세한 내용은 Direct Calculations on Tables and Timetables 항목을 참조하십시오.
R2023a: 누락값 조건 지정
평균값을 구할 때 "includemissing"
또는 "omitmissing"
옵션을 사용하여 입력 배열의 모든 누락값을 포함하거나 생략합니다. 이전에는 "includenan"
, "omitnan"
, "includenat"
, "omitnat"
로 입력 배열의 데이터형에 한정된 누락값 조건을 지정했습니다.
R2023a: 그룹 크기가 작은 경우의 성능이 향상됨
연산 차원이 지정되지 않은 경우 mean
함수로 실수형 벡터에 대해 계산할 때의 성능이 향상되었습니다. 이 함수는 R2022b보다 R2023a에서 디폴트 연산 차원을 더 빠르게 결정합니다.
예를 들어, 다음 코드는 디폴트 벡터 차원을 따라 평균값을 구합니다. 이 코드는 이전 릴리스보다 약 2.2배 빠릅니다.
function timingMean A = rand(10,1); for i = 1:8e5 mean(A); end end
대략적인 실행 시간은 다음과 같습니다.
R2022b: 0.91초
R2023a: 0.41초
코드 실행 시간은 Windows® 10, Intel® Xeon® CPU E5-1650 v4 @ 3.60GHz 테스트 시스템에서 timeit
함수를 사용하여 측정했습니다.
timeit(@timingMean)
R2018b: 여러 차원에 대해 연산 수행
한 번에 입력 배열의 여러 차원에 대해 연산을 수행합니다. 연산 차원으로 구성된 벡터를 지정하거나, 모든 배열 차원에 대해 연산을 수행하도록 "all"
옵션을 지정하십시오.
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)