이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

head

테이블, 타임테이블 또는 tall형 배열의 상단 행 가져오기

구문

B = head(A)

B = head(A,k)

head(___)

설명

B = head(A)는 테이블, 타임테이블 또는 tall형 배열 A의 처음 8개 행을 반환합니다.

B = head(A,k)는 A의 처음 k개 행을 반환합니다.

head(___)는 값을 반환하지 않고 A의 처음 8개 행 또는 처음 k개 행을 표시합니다.

예제

테이블의 처음 8개 행 반환하기

스프레드시트에서 데이터를 읽어 테이블을 만듭니다. 테이블의 크기를 표시합니다. 그러면 행이 1468개임이 표시됩니다.

T = readtable("outages.csv","TextType","string");
size(T)

ans = 1×2

        1468           6

T의 처음 8개 행을 가진 또 다른 테이블을 반환합니다.

T2 = head(T)

T2=8×6 table
      Region          OutageTime        Loss     Customers     RestorationTime           Cause      
    ___________    ________________    ______    __________    ________________    _________________

    "SouthWest"    2002-02-01 12:18    458.98    1.8202e+06    2002-02-07 16:50    "winter storm"   
    "SouthEast"    2003-01-23 00:49    530.14    2.1204e+05                 NaT    "winter storm"   
    "SouthEast"    2003-02-07 21:15     289.4    1.4294e+05    2003-02-17 08:14    "winter storm"   
    "West"         2004-04-06 05:44    434.81    3.4037e+05    2004-04-06 06:10    "equipment fault"
    "MidWest"      2002-03-16 06:18    186.44    2.1275e+05    2002-03-18 23:23    "severe storm"   
    "West"         2003-06-18 02:49         0             0    2003-06-18 10:54    "attack"         
    "West"         2004-06-20 14:39    231.29           NaN    2004-06-20 19:16    "equipment fault"
    "West"         2002-06-06 19:28    311.86           NaN    2002-06-07 00:51    "equipment fault"

테이블의 처음 3개 행 표시하기

1468개 행을 가진 파일에서 테이블을 만듭니다.

T = readtable("outages.csv","TextType","string");
size(T)

ans = 1×2

        1468           6

처음 세 개의 행을 표시합니다. 출력 인수를 지정하지 않으면 head는 값을 반환하지 않습니다. 테이블의 상단을 표시하기만 합니다.

head(T,3)

      Region          OutageTime        Loss     Customers     RestorationTime         Cause     
    ___________    ________________    ______    __________    ________________    ______________

    "SouthWest"    2002-02-01 12:18    458.98    1.8202e+06    2002-02-07 16:50    "winter storm"
    "SouthEast"    2003-01-23 00:49    530.14    2.1204e+05                 NaT    "winter storm"
    "SouthEast"    2003-02-07 21:15     289.4    1.4294e+05    2003-02-17 08:14    "winter storm"

tall형 테이블의 상단을 추출해서 보기

tall형 테이블을 만듭니다. 그런 다음 데이터의 처음 8개 행을 추출하여 표시합니다.

airlinesmall.csv 데이터 세트에 대한 tall형 테이블을 생성합니다. 사용할 테이블 변수의 서브셋을 선택합니다.

varnames = ["Year","Month","ArrDelay","DepDelay","UniqueCarrier"];
ds = tabularTextDatastore("airlinesmall.csv","TreatAsMissing","NA",...
     "SelectedVariableNames",varnames,"TextType","string");
T = tall(ds)

T =

  Mx5 tall table

    Year    Month    ArrDelay    DepDelay    UniqueCarrier
    ____    _____    ________    ________    _____________

    1987     10          8          12           "PS"     
    1987     10          8           1           "PS"     
    1987     10         21          20           "PS"     
    1987     10         13          12           "PS"     
    1987     10          4          -1           "PS"     
    1987     10         59          63           "PS"     
    1987     10          3          -2           "PS"     
    1987     10         11          -1           "PS"     
     :        :         :           :              :
     :        :         :           :              :

데이터의 처음 8개 행을 추출하기 위해 head를 사용합니다. 결과는 행이 8개인 tall형 테이블입니다.

tt = head(T)

tt =

  8x5 tall table

    Year    Month    ArrDelay    DepDelay    UniqueCarrier
    ____    _____    ________    ________    _____________

    1987     10          8          12           "PS"     
    1987     10          8           1           "PS"     
    1987     10         21          20           "PS"     
    1987     10         13          12           "PS"     
    1987     10          4          -1           "PS"     
    1987     10         59          63           "PS"     
    1987     10          3          -2           "PS"     
    1987     10         11          -1           "PS"     

gather 함수를 사용하여 데이터를 메모리로 수집합니다. 결과는 행이 8개인 일반 테이블입니다.

t8 = gather(tt)

t8=8×5 table
    Year    Month    ArrDelay    DepDelay    UniqueCarrier
    ____    _____    ________    ________    _____________

    1987     10          8          12           "PS"     
    1987     10          8           1           "PS"     
    1987     10         21          20           "PS"     
    1987     10         13          12           "PS"     
    1987     10          4          -1           "PS"     
    1987     10         59          63           "PS"     
    1987     10          3          -2           "PS"     
    1987     10         11          -1           "PS"     

tall형 배열에서 지정된 개수의 행 가져오기

tall형 테이블에서 처음 20개 행의 데이터를 미리 봅니다.

airlinesmall.csv 데이터 세트에 대한 tall형 테이블을 생성합니다. 사용할 변수의 일부를 선택하고 "NA" 값을 누락된 데이터로 처리합니다. 그러면 datastore가 이 값을 NaN 값으로 대체합니다. head를 사용하여 처음 20개 행의 데이터를 표시합니다.

varnames = ["Year","Month","ArrDelay","DepDelay","UniqueCarrier"];
ds = tabularTextDatastore("airlinesmall.csv","TreatAsMissing","NA",...
     "SelectedVariableNames",varnames,"TextType","string");
T = tall(ds)

T =

  Mx5 tall table

    Year    Month    ArrDelay    DepDelay    UniqueCarrier
    ____    _____    ________    ________    _____________

    1987     10          8          12           "PS"     
    1987     10          8           1           "PS"     
    1987     10         21          20           "PS"     
    1987     10         13          12           "PS"     
    1987     10          4          -1           "PS"     
    1987     10         59          63           "PS"     
    1987     10          3          -2           "PS"     
    1987     10         11          -1           "PS"     
     :        :         :           :              :
     :        :         :           :              :

tt = head(T,20)

tt =

  20x5 tall table

    Year    Month    ArrDelay    DepDelay    UniqueCarrier
    ____    _____    ________    ________    _____________

    1987     10          8          12           "PS"     
    1987     10          8           1           "PS"     
    1987     10         21          20           "PS"     
    1987     10         13          12           "PS"     
    1987     10          4          -1           "PS"     
    1987     10         59          63           "PS"     
    1987     10          3          -2           "PS"     
    1987     10         11          -1           "PS"     
     :        :         :           :              :
     :        :         :           :              :

결과를 메모리에 수집하여 데이터를 확인합니다.

t20 = gather(tt)

t20=20×5 table
    Year    Month    ArrDelay    DepDelay    UniqueCarrier
    ____    _____    ________    ________    _____________

    1987     10          8          12           "PS"     
    1987     10          8           1           "PS"     
    1987     10         21          20           "PS"     
    1987     10         13          12           "PS"     
    1987     10          4          -1           "PS"     
    1987     10         59          63           "PS"     
    1987     10          3          -2           "PS"     
    1987     10         11          -1           "PS"     
    1987     10          3           3           "PS"     
    1987     10          2           1           "PS"     
    1987     10         16          15           "PS"     
    1987     10          3           9           "PS"     
    1987     10         39          15           "PS"     
    1987     10         57          32           "TW"     
    1987     10          0          -3           "TW"     
    1987     10        -14           0           "TW"     
      ⋮

입력 인수

A — 입력 배열

테이블 | 타임테이블 | tall형 배열

입력 배열로, table형, timetable형 또는 tall형 배열로 지정됩니다.

k — 추출할 행 개수

스칼라

추출할 행 개수로, 양의 정수 스칼라로 지정됩니다. A의 행 개수가 k보다 적으면 head는 A를 모두 반환합니다.

출력 인수

B — 요청된 행

테이블 | 타임테이블 | tall형 배열

요청된 행으로, table형, timetable형 또는 tall형 배열로 반환됩니다. B의 데이터형은 A의 데이터형과 같습니다.

확장 기능

tall형 배열

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

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

head와 tail은 모든 유효한 기본 데이터형(single, double, int8, datetime, table 등)의 tall형 배열에 사용할 수 있습니다.

gather(A)에서 반환되는 결과가 메모리에 맞는지 확실치 않을 경우에는 gather(head(A)) 또는 gather(tail(A))를 사용하십시오. 이러한 명령은 여전히 tall형 배열 A를 완전히 계산하지만, 결과의 일부만 메모리에 반환합니다.

GPU 배열

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

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

분산 배열

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

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

버전 내역

R2016b에 개발됨

R2022b: 지정된 출력 인수 없이 head 함수를 호출하면 ans에 출력값이 저장되지 않음

지정된 출력 인수 없이 head 함수를 호출하면 head 함수는 선택된 테이블 행을 표시하지만 ans 변수에 출력값을 저장하지는 않습니다. 이전 릴리스에서는 지정된 출력 인수 없이 head 함수를 호출하면 ans에 출력값을 저장합니다.

라이브 스크립트에서 head 함수를 호출하는 것은 일반적으로 권장되지 않습니다. 대신, 세미콜론을 붙이지 않고 변수 이름을 입력하여 테이블이나 타임테이블을 표시하십시오. 라이브 편집기는 전체 테이블이나 타임테이블을 검토할 수 있는 위젯을 제공합니다. 그러나 라이브 스크립트에서 head 함수를 호출하려면 출력값을 변수에 할당하는 것이 좋습니다. 이렇게 하면 라이브 스크립트가 출력값에 대한 위젯을 만들 수 있습니다.

참고 항목

tall | gather | tail | topkrows | table | timetable | summary

도움말 항목

• Index and View Tall Array Elements

×

예제 열기

이 예제의 수정된 버전이 있습니다. 사용자가 편집한 내용을 반영하여 이 예제를 여시겠습니까?

아니요, 수정된 버전을 덮어씁니다. 예