Main Content

readall

데이터저장소의 모든 데이터 읽기

설명

예제

data = readall(ds)ds로 지정된 데이터저장소의 모든 데이터를 반환합니다. 데이터저장소의 모든 데이터가 메모리에 다 담기지 않을 정도로 크면 readall은 오류를 반환합니다.

예제

data = readall(ds,UseParallel=tf)tftrue인 경우 데이터를 병렬로 읽어 들입니다(Parallel Computing Toolbox™ 필요).

예제

모두 축소

네 개의 이미지가 포함된 ImageDatastore 객체를 만듭니다.

imds = imageDatastore({'street1.jpg','street2.jpg','peppers.png','corn.tif'});

데이터저장소의 모든 데이터를 읽어 들입니다.

T = readall(imds);

출력값을 검토합니다.

imout = imtile(T);
imshow(imout)

Figure contains an axes object. The axes object contains an object of type image.

테이블 형식 데이터가 포함된 샘플 파일 airlinesmall.csv에서 데이터저장소를 만듭니다.

ds = tabularTextDatastore("airlinesmall.csv",TreatAsMissing="NA");

SelectedVariableNames 속성을 사용하여 필요한 변수를 지정합니다.

ds.SelectedVariableNames = ["DepTime","ArrTime","ActualElapsedTime"];

데이터저장소의 모든 데이터를 병렬로 읽어 들입니다.

T = readall(ds,UseParallel=true);

readall은 모든 데이터를 테이블로 반환합니다.

테이블에 대한 정보를 확인합니다. 선택한 변수만 출력값에 포함됩니다.

T.Properties
ans = 
  TableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Row'  'Variables'}
           VariableNames: {'DepTime'  'ArrTime'  'ActualElapsedTime'}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowNames: {}
        CustomProperties: No custom properties are set.
      Use addprop and rmprop to modify CustomProperties.

기본 데이터저장소의 이미지 쌍 사이에 패리티를 유지하는 데이터저장소를 만듭니다. 예를 들어, 두 개의 개별 이미지 데이터저장소를 만든 다음 이 두 개의 기본 데이터저장소를 결합한 데이터저장소를 만듭니다.

3개의 이미지 모음을 나타내는 이미지 데이터저장소 imds1을 만듭니다.

imds1 = imageDatastore({'street1.jpg','street2.jpg','peppers.png'}); 

imds1의 이미지를 회색조로 변환한 다음 이미지의 크기를 줄여서 두 번째 데이터저장소 imds2를 만듭니다.

imds2 = transform(imds1,@(x) imresize(im2gray(x),0.5));

imds1imds2에서 결합된 데이터저장소를 만듭니다.

imdsCombined = combine(imds1,imds2);

결합된 데이터저장소에서 모든 데이터를 읽어 들입니다. 출력값은 3×2 셀형 배열입니다. 두 개의 열은 두 개의 기본 데이터저장소 imds1imds2에서 읽어 들인 모든 데이터를 각각 나타냅니다.

dataOut = readall(imdsCombined)
dataOut=3×2 cell array
    {480x640x3 uint8}    {240x320 uint8}
    {480x640x3 uint8}    {240x320 uint8}
    {384x512x3 uint8}    {192x256 uint8}

입력 인수

모두 축소

입력 데이터저장소입니다. readall 메서드에는 다음과 같은 데이터저장소를 입력값으로 사용할 수 있습니다.

데이터를 병렬로 읽어 들이는 것으로, true 또는 false로 지정됩니다. true로 지정하면, readall은 데이터저장소에서 모든 데이터를 병렬로 읽어 들입니다(Parallel Computing Toolbox 필요). 병렬로 읽어 들이면 데이터를 읽어올 때(특히 원격 데이터) 성능이 향상됩니다.

  • UseParallel 속성과 Parallel Computing Toolbox를 사용하여 데이터저장소 처리 성능을 향상할 수 있습니다. readall은 스레드 기반 병렬 풀과 같은 낮은 오버헤드의 계산 환경을 사용하여 로컬 컴퓨터에서 지원되는 데이터저장소를 더 빠르게 읽어옵니다. 스레드 기반 병렬 풀에 대한 자세한 내용은 parpool (Parallel Computing Toolbox)을 참조하십시오.

  • MATLAB의 내장 멀티스레딩의 결과로, 특정 데이터저장소(예: imageDatastore)는 MATLAB 워커 기반의 병렬 처리를 사용하지 않을 때 로컬 컴퓨터에서 더 빠르게 수행됩니다. 자세한 내용은 MATLAB Multicore 항목을 참조하십시오.

예: readall(ds,UseParallel=true)

출력 인수

모두 축소

데이터저장소의 모든 데이터로, ds의 유형에 따라 테이블이나 셀형 배열로 반환됩니다.

데이터저장소 유형data의 데이터형설명
TabularTextDatastore, SpreadsheetDatastore테이블SelectedVariableNames 속성은 테이블 변수를 지정합니다.
ImageDatastore셀형 배열 셀형 배열의 각 요소는 하나의 이미지에 대한 이미지 데이터를 포함합니다. readall 함수는 imread 함수에서 지원되는 모든 이미지 유형을 지원합니다. 지원되는 이미지 유형에 대한 자세한 내용은 imread를 참조하십시오.
KeyValueDatastore테이블테이블 변수 이름은 KeyValue입니다.
FileDatastore셀형 배열셀형 배열의 각 요소는 ReadFcn 속성으로 지정된 사용자 지정 읽기 함수를 사용하여 하나의 파일에서 읽어 들인 데이터를 포함합니다.
TransformedDatastore입력 데이터저장소와 변환 함수에 따라 달라짐TransformedDatastore는 기본 데이터저장소에서 읽어 들이고, 연결된 변환 함수를 호출한 다음, 데이터를 세로로 결합합니다. 기본 데이터저장소가 균일하지 않고 이 데이터저장소의 데이터를 세로로 결합하고 싶으면 변환 함수 출력값을 중괄호로 묶으십시오.
CombinedDatastore입력 데이터저장소에 따라 달라짐

기본 데이터저장소가 균일하면 해당 데이터를 아무런 수정 없이 다른 모든 데이터저장소의 데이터와 결합(가로 결합)합니다.

기본 데이터저장소가 균일하지 않으면 먼저 해당 데이터를 셀 안에 묶은 다음 다른 모든 데이터저장소의 데이터와 결합(가로 결합)합니다.

SequentialDatastore입력 데이터저장소에 따라 달라짐

출력값은 기본 데이터저장소의 모든 데이터를 수직으로 결합한 결과입니다.

기본 데이터저장소가 모두 비어 있는 경우 출력값은 첫 번째 기본 데이터저장소를 기반으로 하는 빈 유형입니다. 기본 데이터저장소가 없는 경우 출력값은 빈 double형입니다.

기본 데이터저장소가 균일하면 해당 데이터를 아무런 수정 없이 다른 모든 데이터저장소의 데이터와 결합합니다.

기본 데이터저장소가 균일하지 않으면 먼저 해당 데이터를 셀 안에 묶은 다음 다른 모든 데이터저장소의 데이터와 결합합니다.

확장 기능

버전 내역

R2014b에 개발됨

참고 항목

| |