Main Content

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

readall

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

설명

예제

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

예제

data = readall(ds,'UseParallel',tf)는 병렬로 데이터를 읽어 들입니다(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. The axes 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(rgb2gray(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 메서드에는 다음과 같은 데이터저장소를 입력값으로 사용할 수 있습니다.

  • MATLAB® 데이터저장소 — MATLAB datastore 함수를 사용하여 생성된 데이터저장소입니다. 예를 들어, ImageDatastore를 사용하여 이미지 모음을 위한 데이터저장소를 생성합니다. 데이터저장소의 전체 목록을 보려면 Select Datastore for File Format or Application 항목을 참조하십시오.

  • 결합되고 변환된 데이터저장소 — combine 함수와 transform 함수를 사용하여 생성된 데이터저장소입니다.

  • 사용자 지정 데이터저장소 — 사용자 지정 데이터저장소 프레임워크를 사용하여 생성된 데이터저장소입니다. Develop Custom Datastore 항목을 참조하십시오.

데이터를 병렬로 읽어 들이는 것으로, 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의 데이터형설명
TabularTextDatastoreSpreadsheetDatastore테이블SelectedVariableNames 속성은 테이블 변수를 지정합니다.
ImageDatastore셀형 배열 셀형 배열의 각 요소는 하나의 이미지에 대한 이미지 데이터를 포함합니다. readall 함수는 imread 함수에서 지원되는 모든 이미지 유형을 지원합니다. 지원되는 이미지 유형에 대한 자세한 내용은 imread를 참조하십시오.
KeyValueDatastore테이블테이블 변수 이름은 KeyValue입니다.
FileDatastore셀형 배열셀형 배열의 각 요소는 ReadFcn 속성으로 지정된 사용자 지정 읽기 함수를 사용하여 하나의 파일에서 읽어 들인 데이터를 포함합니다.
TransformedDatastore각각 다름출력값은 UnderlyingDatastores 속성으로 지정된 기본 데이터저장소에서 반환되는 출력값과 동일합니다. 예를 들어, 기본 데이터저장소가 이미지 데이터저장소이면 data는 셀형 배열의 각 요소가 하나의 이미지에 대한 이미지 데이터를 포함하는 셀형 배열로 반환됩니다.
CombinedDatastore셀형 배열

셀형 배열의 각 열은 UnderlyingDatastores 속성으로 지정된 대응하는 기본 데이터저장소에 대해 readall을 호출한 결과를 포함합니다.

기본 데이터저장소에 있는 데이터 서브셋의 개수가 다른 경우, readall은 모든 기본 데이터저장소에 데이터가 있는 경우에만 데이터를 반환합니다. 예를 들어, 결합된 데이터저장소에 두 개의 기본 데이터저장소가 있는데, 하나는 m개의 데이터 서브셋을 가지고 있고 다른 하나는 n개의 서브셋을 가지고 있다고 가정하겠습니다. 여기서 m > n입니다. 이 경우 출력값은 두 개의 열과 n개의 행으로 구성된 셀형 배열입니다.

확장 기능

참고 항목

| |

R2014b에 개발됨